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package com. thinairapps . tag . wml ; 
import com. thinairapps .tag. *; 
/** 

* This is the main container for all WML documents. It is directly analogous to a WML file 

containing 

* any number of cards and card elements. 
*/ 

public class WMLTagDocument extends TagDocument 

public final static String DEFAULT_XML_LANG = "en-us"; 

public final static String XML_HEADER = "<?xml version=\"l. 0\"?>" ; 

public static String DOC_TYPE = "<!DOCTYPE wml PUBLIC \ " - //WAPFORUM//DTD WML 1.1//EN »^ 
\" \ "http://www.wapforum.org/DTD/wml_l . 1 .xml\">" ; 

Head head; 
Template template, - 
Card card; 

/**Creates a standard WMLTagDocument C&lt ; wml&gt ; &lt ; /wml&gt ; ) 

; public WMLTagDocument ( ) { 

'^z super ("wml", "text/vnd.wap.wml") ; 

SJ /**Creates a WMLTagDocument with the specified 'xml:lang' attribute. In general, 

* you should use the no arg constructor. 

* ©param xml_lang the specified xml : lang type . 

public WMLTagDocument (String xml_lang) { 
thisO ; 

^ getRootO .addAttribute{ "xml: lang", xml_lang) ; 
/**Set's the Head tag for this deck. 

*/ 

public void setHead(Head head) throws InvalidTagException { 
this. head = head; 
resetChildrenO ; 

} 

/**Set's a Template for this deck. 
*/ 

public void setTemplate (Template template) throws InvalidTagException { 
this . template = template; 
resetChildrenO ; 

} 

public void setCard(Card card) throws InvalidTagException { 
this. card = card; 
resetChildrenO ; 

} 

/***Adds a Card to this document. 

* @param card A Card to be added to this document. 
*/ 

public void addCard(Card card) { 
try { addChild(card) ; } 
catch (InvalidTagException e) { 
e.printStackTrace () ; 

} 
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/***This clears all of the children for this Card. 
*/ 

private void resetChildren { ) throws Inval idTagException { 

getRootO .getChildren ( ) . retnoveAllEleraents ( ) ; 

if (head 1= null) 

addChild(head) ; 

if (template £= null) 
addChild (template) ; 

if (card != null) 
addChild(card) ; 

} 

/***This renders the entire WMLTagDocument . 

* Oreturn String the document rendered to a String. 

public String render ( ) { 

StringBuffer output = new StringBuf f er ( ) ; 
output .append (XML_HEADER + "\n"),- 
output . append (DOC_TYPE + "\n\n"); 

output . append ( super . render ( ) ) ; 

return output . toString ( ) ; 
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package com. thinairapps . tag . wml ; 
import com. thinairapps . tag .* ; 
import java . util .Enumeration ; 



*^The basic WMLTag which all other tag classes in this package subclass 
public class WMLTag extends Tag 

* (Sparam name the tag text to use <"name"> 

* ©param closingTag indicates if this is a standalone tag, or if it has an accompanying ^ 

closing tag 

*/ 

public WMLTag (String name, boolean closingTag) 
super (name, closingTag) ; 



/** 

* @param name the tag text to use <"name"> 
*/ 

public WMLTag (String name) 
super (name) ; 

} 

/** 

* called by the render () method to render the start tag 

protected String renderOpenTag ( ) { 

StringBuffer output = new StringBuf f er ( ) ; 

//render self open 
output . append { " < " ) ; 
output . append (getName ( ) ) ; 

Enumeration eAttribs = getAttributes (). elements () ; 

while (eAttribs .hasMoreElements ( ) ) 

output . append ( " " + ( (Attribute) eAttribs .nextElement ()). render ()) ; 

if ( ! isClosedTag ( ) ) 

output . append ( " / " ) ; 

output . append ( " > " ) ; 

return output . toString () ; 
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package com. thinairapps . tag . wml ; 

import com . thinairapps . tag . AbstractCharacterEncoder ; 
/** 

* A utility class that reformats characters, such as <, 

* >, ',&,$, etc. which are reserved for 

* use by WML/WAP, and that must been encoded in all uses. 

* This class is a singleton so it has a private constructor 

* ©author kleemax 
*/ 

public class WMLCharacterEncoder extends AbstractCharacterEncoder 
{ 

/////////////////////////////////////////////////////////// 
// CONSTANTS 

private final static String [] ENCODED_STRINGS = { " &amp ; " , 

"<%' 
" &gt ; " , 
"Sapos; " , 

"$$", 

"&apos; " } ; 

// AMPERSAND 
// QUOTE 
// LESS THAN 
// GREATER THAN 
// the ' apostrophy 
// DOLLARS I GN 
// NEW LINE 
// LINE FEED 
// TRADEMARK 
// FORWARD APOSTROPHY 

// UNUSED 

private final static String SOFT__HYPHEN = "­"; 
private final static String NON_BREAKING_SPACE = " "; 

MV/ ///////////////////////////////////////////// ////////// 
II VARIABLES 

private static WMLCharacterEncoder s_Singleton = null; 

IIIIIIIIIIIIIIHIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII 
II PRIVATE CONSTRUCTOR 

private WMLCharacterEncoder ( ) { 

// Singleton. No constructor 

} 

llllll/ltllllllllllllllllllllllllllllllllllllllllllllllllll 
II ABSTRACT METHODS OVERRIDDEN FROM SUPERCLASS 

/**Allows the subclass to specify the list of characters that should 

* be encoded. Note that this list should have the same number of 

* elements, with each element in the same position, as the array 

* that is returned from getEncodedStrings ( ) . 

* ©return A list of special characters which should be encoded in 

* the current markup language. 
*/ 

protected char[] getCharactersToEncode ( ) { 
return CHARS TO ENCODE ; 

} 



private final static char[] CHARS_TO_ENCODE = 



39, 
■$', 
•\n', 
'\r' , 
8482, 



/**Allows the subclass to specify the list of strings that should 
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* be used as escape sequences for each character that should be 

* encoded. Note that this list should have the same number of 

* elements, with each element in the same position, as the array 

* that is returned from getCharactersToEncode ( ) . 

* ©return A list of strings which are valid escape sequences in 

* the current markup language. 
*/ 

protected String [] getEncodedStrings ( ) { 
return ENCODED STRINGS; 

} 

/////////////////////////////////////////////////////////// 
// METHODS 

public Static String clipAndEncode (String inText, int inStart, 

int inLength, String inTail, int[] outLengthUsed) { 
if {s_Singleton == null) { 

s_Singleton = new WMLCharacterEncoder () ; 

} 

s_Singleton.clipAndEncodeWithTail (inText, inStart, inLength, inTail, 
tLengthUsed) ,- 
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package com. thinairapps . tag . wml ; 

import j ava .util . Enumeration; 
import java.util .Properties, • 

import java .net -URLEnc Oder ; 

/**This is a convenience class for building URLs (href Strings) suitable for use within 
various markup languages . 

*/ 

public class URLBuilder 
{ 

public static String DELIMETER = "&"; 
public static String NAME_VALUE_DELIMETER = " = " ; 

private final static String RJSID_KEY = "trnd"; 
private final static String DEFAULT_BASE_URL = "?"; 

/**Builds a URL suitable for use within a WML deck. 

*@param baseURL the domain name, path, etc. as needed. Everything required before the / 
•7 < . 

*@param props a Properties object containing the name value pairs of the HTTP URL kT 
parameters . 

*@param addRandora indicates if a random parameter should be added in the form, ' trnd 
="1234" ' . This 

* is used as a means to force browsers not to use cached pages. 
*/ 

public static String buildWapUrl (String baseUrl, Properties props, boolean addRandom) 



StringBuffer url = new StringBuf f er ( ) ; 

if (baseUrl != null) 
{ 

url. append (baseUrl); 

if ( ! baseUrl . endsWith (DEFAULT_BASE_URL) ) 
url. append (DEFAULT BASE URL) ; 

llse ~ " 

url . append (DEFAULT_BASE_URL) ; 

Enumeration enura = props . keys () ; 

String key = null, value = null ; 

wh i 1 e ( enum . ha sMoreE 1 ement s ( ) ) 
{ 

key = (String) enum. nextElement 0 ; 

value = props -getProperty (key) ; 

if ( lvalue . startsWith( "$") ) 

value = URLEncoder . encode (value) ; 

url. append (key) ; 

url. append (NAME_VALUE_DELIMETER) ,- 
url. append (value); 

if (enum.hasMoreElementsO ) 
url . append (DELIMETER) ; 

} 

if (addRandom) 
{ 

url . append (DELIMETER) ; 
url. append (RND_KEy) ; 
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url. append (NAME_VALUE_DELIMETER) ; 
url . append (genRnd ( ) ) ; 



url .toString ( ) ; 



private static String genRnd () 

String rnd = new j ava . util . Date ( ) .getTime ( ) ■ 

//trim the random number to reduce URL size 
int length = rnd. length () ; 
if (length >=4) 

rnd = rnd. substring (length-4 , length) ; 
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package com. thinairapps . tag . wml ; 
/** 

* The &:lt;timer> element provides a method for invoking a task automatically after some ^ 
period of user inactivity. Any task or user action that activates the card starts the 
timer, and executing any task element stops it. You can only associate one task per timeri^' 
, and you can only define one timer per card. 

public class Timer extends WMLTag 

* Oparam name The name of the variable in which the device stores the timer value. If thei^ 

variable has no value when the timer is initialized, the device sets it to the value 
specified for the default attribute. The device sets this variable to either the 
current timer value when the user exits the card or 0 if the timer expires. 

* ©param value A string specifying the value for the variable specified by the key 

attribute. You must specify <timer> values in units of 1/10 seconds--so, for example 
, a value of 100 equals 10 seconds. Specifying a value of 0 disables the timer. 

public Timer (String name,int value) ( 
super ("timer" , false) ; 
addAt tribute ( "name" ,name) ; 
addAttribute ( "value" , value * 10 + ""); 

} 

/** 

* @param value A string specifying the value for the variable specified by the key kf 

attribute. You must specify <timer> values in units of 1/10 seconds--so, for example kf 
^ - a value of 100 equals 10 seconds. Specifying a value of 0 disables the timer. 

public Timer (int value) { 
this ( "default" , value) ; 

} 
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package com . thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/**This is a convenience class for fonnatting Text in a WMLdeck. 



public class TextStyle extends WMLTag 

public final static String PLAIN = " " ; 

public final static String BOLD = "b" ; 

public final static String BIG = "big" ; 

public final static String EMPHASIZE = "em"; 

public final static String ITALIC = "i"; 

public final static String SMALL = "small"; 

public final static String STRONG = "strong"; 

public final static String UNDERLINED = "u" ; 

String style = PLAIN; 

/** 

*@param style one of the String constants defined in this class. 
*/ 

public TextStyle (String style) { 
super ( " " , true) ; 
this. style = style; 

/** 

*@param style one of the String constants defined in this class. 
*@param child a child tag to be formatted in the given syle. 

public TextStyle (String style, WMLTag child) throws InvalidTagException { 
super (" " ,true) ; 
this. style = style; 
addChild (child) ; 

} 

protected String renderOpenTag ( ) { 
if (style != PLAIN) 

return "<" + style + ">"; 

else 

return " " ; 

} 

protected String renderCloseTag ( ) { 
if (style != PLAIN) 

return "</" + style + ">"; 

else 

} ""' 



C : \TASS\ThinAirServer\Platf orni\ . . \com\thinairapps\tag\wml\Text . j ava 



package com . thinairapps . tag . wml ; 
/** 

* This is a simple class that allows you to insert an arbitrary String 

* into a WML Deck. 
*/ 

public class Text extends WMLTag 

/***Create a new Text Object with the given String 

public Text (String text) { 
super (text, false) ; 

} 

/***Get the String you used to define this Text Object. 

public String getTextOnly { ) { 
return getName ( ) ; 

} 

/***Return the Sting defined for this Text Object 

public String render ( ) { 
return getName ( ) ; 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag. InvalidTagException; 

/** 

* Element that defines deck-level event bindings (i.e. characteristics that apply to all 
cards in the deck) 

*/ 

public class Template extends WMLTag 

public Template () { 

super ( "template" ) ; 

/** 

* ©param onEnterForward specifies the URL to open if the user navigates to a card 

through a <goS;gt; task 

* Oparam onEnterBackward specifies the URL to open if the user navigates to a card 

through a &lt ;prev&gt ; task 
*^®param onTimer specifies the URL to open if the &lt ; timer&gt ; element expires 

public Template (String onEnterForward, String onEnterBackward, Strinq onTimer) f 
thisO; ^ ^ 

addAttributeC'onenterforward", onEnterForward) ; 
addAttribute ( "onenterbackward" , onEnterBackward) ; 

^ addAttribute ("ontimer", onTimer) ; 

public void addChi Id (WMLTag child) throws InvalidTagException { 
if (child instanceof Do | | child instanceof OnEvent) 
super. addChild (child) ; 

else 

throw new InvalidTagException ( "Template only supports Do and OnEvent child 
tags") ; 
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package com. thinairapps . tag . wml ; 
/** 

*^The basic Task type which is subclassed by other classes (<go> , <do> 

public abstract class Task extends WMLTag 

public Task (String name, boolean closed) 
{ 

super (name, closed) ; 

} 



C: \TASS\ThinAirServer\ . . \com\thinairapps\tag\wml\TableRow. java l 

package com. thinairapps . tag . wml ; 

import com. thinairapps .tag . InvalidTagException; 

/** 

* The <tr> element is used as a container to hold a single table row. Table rows may bei^ 

empty , 

* in other words, all cells are empty. 
*/ 

public class TableRow extends WMLTag 

public TableRow 0 { 
super ( "tr" ) ; 

} 

public void addChild (WMLTag child) throws InvalidTagException { 
if (child instanceof TableCell) 
super. addChild (child) ; 

else 

throw new InvalidTagException ( "TableRow only supports TableCell child tags"); 

} 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException ; 

/** 

* The <td> element is used as a container to hold a single table cell data within a ^ 

table row. 

* Table data cells may be empty. The user agent should do a best effort to deal with multiple 

line 

* data cells that may result from using images or line breaks. 

public class TableCell extends WMLTag 

public TableCell 0 { 
super ( "td" ) ; 

} 

/♦Constructs a TableCell with the given child tag. 

public TableCell (WMLTag child) throws InvalidTagException { 
thisO ; 

addChild (child) ; 

} 

public void addChild (WMLTag child) throws InvalidTagException { 

if (child instanceof Text | | child instanceof Image | | child instanceof Anchor) 
super. addChild (child) ; 

else 

throw new InvalidTagException ( "TableCell only supports Text, Image, and Anchor 
children tags"); 
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package com. thinairapps . tag . wml ; 
import com. thinairapps . tag . InvalidTagException; 
/* 



allows you to specify columnar format. WML. tables are similar to 
When defining a table, you have to declare the number 



The <table&gt 
HTML 

* tables but with fewer capabilit 

of columns, 

* followed by some content. The content can include empty rows and col- 

WMLTag 



publ 



3S Table exte 

public final static 
public final static 
public final static 

public Tabled { 

super ("table") ; 



String AIjIGN_LEFT = "left"; 
String ALIGN_CENTER = "cente 
String ALIGN_RIGHT = "right" 



/** 

* Oparam title Specifies a label for the table. 

* Oparam align (ALIGN_LEFT, ALIGN_CENTER, ALIGN_RIGHT) Specif: 

to the colunm. 

* If you do not specify the align attribute, the 



text alignment relative 
is automatically left-aligned, 
the row set. Specifying a zero valu 



* @param columns Specifies the number of columns fo: 

for 

* this attribute is not allowed. 
*/ 

public Table (String title, String align, int columns) 
this 0 ; 

addAttribute ( "title" , title) ; 
addAttribute ( "align" , align) ; 
addAttribute ( "columns" , " " + columns) ; 

} 

public void addChild (WMLTag child) throws InvalidTagException ( 
if (child instanceof TableRow) 
super. addChild (child) ; 

else 

throw new InvalidTagException ( "Table only supports TableRow child tags 
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package com. thinairapps . tag . wml ,- 

/**The &1 t ; spawn&gt ; element defines a spawn task, indicating the creation of a child context 

* and invocation of a URL in that child context. If the URL names a WML card or deck, the \^ 

* is displayed, and the URL becomes the basis for a new history stack in the child context. 

See 

* specific WML browser documentation for more details. 
*/ 

public class Spawn extends WMLTag 

public Spawn () 
{ 

super ("spawn", true); 

} 
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package com . thinairapps . tag . wml ; 

import com . t hi na i rapp s . t ag . I nva 1 idTagExc ept ion ; 

* A widget for generating a card with a single text-type input. For details on the 

constructors, see the constructors for 

* Card. 
*/ 

public class SinglelnputCard extends Card 

public SinglelnputCard ( ) { 
super () ; 

public SinglelnputCard (String id) { 
super (id) ; 

public SinglelnputCard (String id, String title) { 
super (id, title) ,- 

public SinglelnputCard (String id, String title , boolean newContext) { 
super (id, title, newContext) ; 

public SinglelnputCard (String id, String title , boolean newContext , boolean ordered) 
super ( id, title , newContext , ordered) ; 



* ©parara href the url to which the results of the select input are to be submited 

* ©param label the label to use with the input field 

* @param name the name of the input field 

* ©param format the format mask to use with the input field 

public void buildCard (String href, String label, String name, String format) 

Do dol = new Do (Do . TYPE_ACCEPT, new Go (href , f al se) ) ; 
addChild(dol) ; 

Paragraph p = new Paragraph ( ) ; 
p.addChild(new Text (label )) ; 
Input input = new Input (name) , ■ 
input . setFormat (format) ; 
p.addChild(input) ; 
addChild(p) ; 

} 

/** 

* Build a Card that uses the POST method 

* (Sparam href the url to which the results of the select input are to be submited 

* @param label the label to use with the input field 

* @param name the name of the input field 

* ©param format the format mask to use with the input field 

* ©param extraFields array of &lt ;postf ield&gt ,- elements 

public void buildPostCard (String href, String label, String name, String format, PostField 
[] extraFields) 

{ 

Go goa = new Go (href, true. Go .METHOD_POST) ; 
goa.addChild(new PostField (name , "$"+name) ) ,- 



if (extraFields != null) 
{ 
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for (int i = 0; i < extraFields . length ; i++) 
goa.addChild{extraFields [i] ) ; 

} 

Do dew = new Do (Do.TYPE_ACCEPT,goa) ; 
addChild(dew) ; 

Paragraph p = new Paragraph ( ) ; 
p.addChild(new Text (label) ) ; 
Input input = new Input (name) ; 
input . setFormat ( format ) ; 
p.addChild(input) ; 
addChild(p) ; 



} 
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package com. thinairapps . tag . wtnl ; 
/** 

* The <setvar> element sets a variable to a specified value when the device executes 

&lt ;go&gt ; , 

* &lt ;prev&gt ; , &lt ; spawn&gt ; , or &lt ; ref resh&gt ; task, 
public class SetVar extends WMLTag 

public SetVar (String name. String value) 

super { "setvar" , false) ; 
addAttribute ( "name" , name) ; 
addAttribute ( "value" , value) ; 
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package com . thinairapps . tag . wml ; 

import com . thinairapps . tag . InvalidTagException ; 
/** 

* A widget for generating a card with a Select list input. For details on the constructors, \£ 

see the constructors for 

* Card. 
*/ 

public class SelectlnputCard extends Card 

public SelectlnputCard 0 { 
super ( ) ; 

public SelectlnputCard (String id) { 
super ( id) ; 

public SelectInputCard(String id, String title) { 
super (id, title) ; 

public SelectlnputCard (String id, String title, boolean newContext) { 
super (id, title, newContext) ; 

public SelectlnputCard (String id, String title, boolean newContext , boolean ordered) { 
super ( id, title , newContext , ordered) ; 

* @param href the url to which the results of the select input are to be submited 

* @param label the text label for this input 

* ©param name the name of the select tag 

* ©param optionVals name/value pairs for all of the options 

* ©param align the text alignment to use for the display (Paragraph . LEFT , etc) 

* @param mode the text wrap mode to use for the display (Paragraph. NO WRAP) 

public void buildCard (String href, String label, String name, String [ ] [] optionVals , String xr 
align, String mode) throws InvalidTagException { 

Option[] options = new Option [optionVals . length] ; 

for (int i = 0; i < optionVals . length; i++) { 

options [i] = new Option (optionVals [i] [1] ) ,- 
^ options [i] . setLabel (optionVals [i] [0] ) ; 

^ buildCard(href, label, name, options, align, mode) ,- 

/** 

* Oparam href the url to which the results of the select input are to be submited 

* ©param label the text label for this input 

* ©param name the name of the select tag 

* ©param options the set of &lt ,-option&gt ; tags to use for this select 

* ©param align the text alignment to use for the display (Paragraph. LEFT, etc) 

* ©param mode the text wrap mode to use for the display ( Paragraph. NO_WRAP) 

public void buildCard (String href. String label. String name. Option [] options , String align, i^- 
String mode) throws InvalidTagException { 

' Go(href, false) ) ; 



Paragraph pHeader = new Paragraph(align, Paragraph. MODE_WRAP) , - 
pHeader.addChild(new Text (label) ) ; 
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addChild(pHeader) ; 

Paragraph p = new Paragraph (align, mode) ; 

Select select = new Select ("", name , false) ; 
Option cOpt = null; 

for (int i = 0; i < options . length ; i++) 
select -addOption (options [i] ) ; 

p.addChild(select) ; 
addChild(p) ; 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . Inval idTagException ; 
/** 

* The S:lt;select> tag element specifies a list of options from which the user can choose 
You can 

*^specify either single- or multiple-choice S;lt;select> tag elements. 

public class Select extends WMLTag 

public Select () { 

^ super ( "select" , true) ; 

/** 

* Oparam name The name of the variable in which the device stores the value (s) associated!,?' 

* the option (s) chosen by the user. The value associated with each option comes from the 

* <option> tag element value attribute. 

* ©param title Specifies a brief label for the S:lt ; select&gt ; list. Some devices use thei^ 

label 

* as^a title when displaying the &lt ; select &gt ; content. Others might use it as a label kT 

* interface mechanism that lets the user navigate to the &lt ; select&gt ; content. For \e 

example, if a 

* device cannot display all card content on one screen and ordered="true" (see Order 

options) , the 

* UP. Browser uses the title to identify this select list on a summary-level menu. 

* @param multiple Specifies whether the user can select multiple items. 

public Select (String title, String name, boolean multiple) { 
r; thisO; 

addAttribute { "title" , title) ; 
addAt tribute ( "name" , name) ; 
^ addAttribute ( "multiple" ," " + multiple); 

public void addChild (WMLTag child) throws Inval idTagException { 
if (child instanceof Option | | child instanceof OptGroup) 
super. addChild(child) ; 

else 

throw new InvalidTagException("Select only supports OptGroup or Option children 
^ tags" ) ; 

public void addOption (Option option) { 

try { addChild (opt ion) ; } 
^ catch (InvalidTagException e) {} 

/** 

*@param defaultValue A string specifying the default value (s) for the variable specified ^ 
by 

* the name attribute . 
*/ 

public void setDefaultValue (String defaultValue) { 

^ addAttribute ( "value" , defaultValue) ; //TODO what is the proper attribute? "value"? 
/** 

* ©param iname Identical to the name attribute except for the following: The specified 

* variable stores the index value(s) associated with the option(s) chosen by the user 1/ 

The 

* index value associated with each option comes from its position in the <i>select</i> kT 

list , 

* starting with 1. If the user has not selected an option, the index value is 0. The \^ 

default 

* value is specified by the lvalue attribute. 



: \TASS\ThinAirServer\Platform\ . . \com\thinairapps\tag\wml\Select . java 



* (sparam lvalue Identical to the default attribute except for the following: The 

specified 

* string contains the default index value (s) for the variable specified by the iname 

attribute. 

*/ 

public void set INameAndlValue (String iName, String lvalue) { 
addAt tribute ( " iname " , iName) ; 
addAttribute ( "lvalue" , lvalue) ; 

} 

public void setTablndex ( int tablndex) { 

addAttribute ( "tablndex" , " " + tablndex) ; 
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package com. thinairapps . tag . wml ; 
/** 

* Used to reset all variables within a deck's current context. 
*/ 

public class Reset extends WMLTag 

public Reset {) 
{ 

super ( "Reset" , false) ; 

} 
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package com, thinairapps . tag . wml ; 



• A utility clai 
reserved for 
■ use by WML/ WAP, and that 

©author kleemax 



that reformats characters, such < 
been encoded in al! 



Sc, $, etc. which are 



public class ReservedCharacter { 

public final static String QUOTE = """; 
public final static String LESS_THAN = "<"; 
public final static String GREATER_THAN = "> 
public final static String APOSTROPHY = "Siapos; 
public final static String AMPERSAND = "&"; 
public final static String DOLLARSIGN = "$$"; 
public final static String SOFT_HYPHEN = "­ 
public final static String NON_BREAKING_SPACE = 
public final static String TRADEMARK = " (TM) " ; 



public final 
/■ 



tatic int ESCSEQ_LENGTH : 



*Processes inText , returning it's substring from inStart so that it is no 
longer than inLength, and has inTail tacked on if it was longer. All of 
the special characters in inText are reformatted to Markup Language Escape 
Sequences. If inTail is not null, then it is tacked onto the end of strings 
which are too long, to show that the string is incomplete. Empty String "" 
is returned if inText is null or "", if inStart is invalid, or if inLength 
is <= 0. 



* ©param inText the raw text that we will clip and encode 

* ©param inStart the starting offset in inText from which we should start the 

* returned string. Nothing before inStart will be included in the return string. 

* ©param inLength the approximate number of characters that we would like our 

* returned string to be. the returned string may be slightly more than inLength 

* if it ends in an escape sequence. 

* ©param inTail if inTail is not null or "", then it will be tacked onto the 

* end of the returned string if we do not all of inText from inStart on. 

* BEWARE: inTail does NOT get URL encoded and Escaped. Make sure that it doesn't 

* contain special characters. 

* ©param outLengthUsed is a call-by-reference parameter. Pass in a non-null 

* int array at least 1 long if you wish to know the number of characters from 

* inText that were actually used in building the return String. 

* outLengthUsed [0] will contain the number of chars from inText which were 

* actually used or escaped in the returned string. This is NOT the length of 

* the returned String. Instead, it is the length of inText that was used in 

* building the returned String. 

* ©return a string that starts from start and is no longer than length, with 

* all of the special characters escaped out. 

* TODO: in the future, this method should look into having a parameter that 

* lets us break on words, rather than just breaking on length. (i.e.: do it 

* word by word, so we don't have incomplete words.) 

public static String cl ipAndEncode (String inText, int inStart, int inLength, 
String inTail, int[] outLengthUsed) { 
/ / Deal with the case when we get bad parameters in 
if (inText == null | | inText . length ( ) == o | [ inStart < 0 | | 
inLength <= O | | inStart >= inText . length () ) { 
if (outLengthUsed != null) { 
outLengthUsed [0] = 0; 

) 

return " " ; 

} 
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// Local variables 

StringBuffer buff = new StringBuf f er ( inLength) ; 
int length = inText . length ( ) , 

used = 0, 

charsVisited = 0; 
char current; 

boolean usingTail = false; 

// Check to see if we need to use the tail 
if {inTail != null && inTail . length ( ) > 0) { 

// add the tail if it is specified 

usingTail = true; 

inLength -= inTail . length {) ; 



// Loop around char by char, inserting the chars into the buffer, 
while (charsVisited < inLength && inStart < length) { 
used++; 

current = inText . charAt (inStart ) ; 

switch (current) { 
case ' &' : 

buff .append (AMPERSAND) ; 

charsVisited += AMPERSAND . length () ; 

break; 

buf f . append (QUOTE) ; 
charsVisited += QUOTE . length () ; 

case ' < ' : 

buff .append (LESS_THAN) ; 

charsVisited += LESS_THAN. lengthO ; 

break; 
case ' > ' : 

buff . append (GREATER_THAN) ; 

charsVisited += GREATER_THAN. length () ; 

case 39: //the ' apostrophy 
buf f . append (APOSTROPHY) ; 
CharsVisited +■= APOSTROPHY. length () ; 

case ' $ ' : 

buf f .append (DOLLARSIGN) ; 
CharsVisited += DOLLARSIGN. length () ; 
break; 

buf f .append ( ' ' ) ; 
charsVisited++ ; 
break; 
case ' \r ' : 

buff . append ( ' ' ) ; 

charsVisited++; 

break; 

case 8482: //the trademark symbol 

buff . append (TRADEMARK) ; 
CharsVisited += TRADEMARK. length () ; 
break; 

case 180: // the forward apostrophe 

buf f . append (APOSTROPHY) ; 

CharsVisited += APOSTROPHY . length () ; 

break ; 
default: 

buf f .append (current) ; 

charsVisited++ ; 

break; 

} 

inStart++; 
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// Add the tail if it was called for, and we didn't iterate over the 
// whole length 

if (usingTail && inStart < length) { 
buff .append (inTail) ; 

} 

// Now report the length used if it is asked for (by passing 
// in a non-null outLengthUsed 

if (outLengthUsed != null && outLengthUsed. length > 0) { 
outLengthUsed [0] = used; 

} 



return buf f . toString ( ) ; 

// Should this be .trimO trimmed? 

} 
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package com. thinairapps . tag . wtnl ; 

import com . thinairapps . tag . InvalidTagException ,- 

/** 

* The <ref resh> element is a task element that instructs the device to refresh the 

specified card variables. The device also refreshes the display if any of those variables 
are currently shown. 

*/ 

public class Refresh extends Task 
{ 

public Refresh 0 { 

super ("refresh" , true) ; 



public Refresh (boolean closing) { 
super ( "refresh" , closing) ; 

public void addChild (WMLTag child) throws InvalidTagException { 
if (this.isClosedTagO ) 

if (child instanceof SetVar) 
super. addChild(child) ; 

else 

throw new InvalidTagException ( "Refresh only supports SetVar children tags"); 



} 



throw new InvalidTagException ( "Tag must be a closing tag to support children"); 



C : \TASS\ThinAirServer\Platf orm\ . . \com\thinairapps\tag\wml\Prev . j ava 1 

package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* The <prevS:gt; element is a task element that instructs the device to remove the current ^ 

URL from 

* the history stack and open the previous URL. If no previous URL exists on the history stacki^ 

, specifying <prev> has no effect. 

*/ 

public class Prev extends Task 
{ 

/♦Constructs a new Prev tag. 
*/ 

public PrevO { 

super ( "prev" , true) ; 

/♦Constructs a new opening or closing Prev tag, depending on the 'closing' parameter. 
*/ 

public Prev (boolean closing) { 
^ super ("prev" , closing) ; 

public void addChild (WMLTag child) throws InvalidTagException { 
if (this . isClosedTag ( ) ) 

if (child instanceof SetVar) 
super. addChild(child) ; 

throw new InvalidTagException ( "Prev only supports SetVar children tags"); 

else 

throw new InvalidTagException ( "Tag must be a closing tag to support children"); 
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package com. thinairapps .tag . wml ; 
/** 

* The Sclt/postf ield&gt ; element defines name/value pairs that are passed to the HTTP server \i 

* the <go> request. See the <go> element for an example of the &lt ;postf ield&gt ; 

element ' s use 

* in WML. 
*/ 

public class PostField extends WMLTag 
/** 

*@param name A label that identifies the field. 

*@parara value A string specifying the default value for the variable specified by the 
value attribute. 

*/ 

public PostField (String name, String value) { 
super ("postfield", false) ; 
addAttribute ( "name" , name) ; 
addAttribute ( "value" , value) ; 
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package com. thinairapps . tag . wtnl ; 

import com. thinairapps . tag . Inval idTagException ; 

/** 

* A WML Widget used to create a card with a labeled text input using a Password mask. 

For constructor details, 

* see Card. 
*/ 

public class PasswordlnputCard extends Card 



public PasswordlnputCard ( ) 
super, ( ) ; 



public PasswordlnputCard (String id) 
super (id) ; 



public PasswordlnputCard (String id, String title) 
super (id, title) ; 



public PasswordlnputCard (String id. String title, boolean newContext) 
super (id, title, newContext) ; 



public PasswordlnputCard (String id, String title, boolean newContext, boolean ordered) 
super ( id , title , newContext , ordered) ; 



*@param href the link to submit the input to 

*@param label the text label to display next to the input 

*@param the name of the field 

*@param the format to use for the field (*M,n) 
*/ 

public void buildCard (String href. String label. String name. String format) throws 
InvalidTagException 



Do dol = new Do (Do . TYPE_ACCEPT, new Go (href , false) ) ; 
addChild{dol) ; 

Paragraph p = new Paragraph ( ) ; 
p.addChild(new Text (label) ) ; 
Input input = new Input (name) ; 
input . setType ( "password" ) ; 
input . setFormat (format) ; 

input. setValue ("") ; // parksan (10/17/2k) - added this to remove caching 

p.addChild(input) ; 
addChild(p) ; 



/** 

* Oparam href the link to submit the input to 

* @param label the text label to display next to the input 

* ©param name the name of the field 

* ©param format the format to use for the field (*M,n) 

* ©param extraFields an array of PostFields posted to the server along with the user's 

form input 

*/ 

public void buildPostCard (String href. String label. String name. String format. 
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PostFieldl] extraFields) 

{ 

Go goa = new Go (href , true. Go . METHOD_POST) ; 
goa.addChild(new PostField (name, "$"+name) ) ; 

if (extraFields != null) 
{ 

for (int i = 0; i < extraFields . length; i++) 
goa. addChild( extraFields [i] ) ; 

} 

Do dew = new Do (Do . TYPE_ACCEPT, goa) ; 
addChild(dew) ; 

Paragraph p = new Paragraph ( ) ; 
p.addChild(new Text ( label )) ; 
Input input = new Input (name) ; 
input . setType ( "password" ) ; 
input . setFormat (format) ; 

input. setValue ("") ; // parksan (10/l7/2k) - added this to remove caching 

p.addChild(input) ; 
addChild(p) ; 



C:\TASS\ThinAirServer\. ■ \com\thinairapps\tag\wTnl\Paragraph. java 

package com . thinairapps . tag . wml ; 

import com. thinairapps .tag . InvalidTagException; 

/** 

* The <p> tag element specifies a new paragraph and has alignment and line-wrappinq 
attributes. 

*/ 

public class Paragraph extends WMLTag 

public final static String AI.IGN_LEFT = "left"; 
public final static String ALIGN_CENTER = "center" ; 
public final static String ALIGN_RIGHT = "right"; 

public final static String MODE_WRAP = "wrap" ; 
public final static String MODE_NOWRAP = "nowrap"; 

public Paragraph {) 

super ("p") ; 

} 

/** 

* ©param align (ALIGN_LEFT, ALIGN-_CENTER, ALIGN_RIGHT) Specifies line alignment relativ. 

to the display area. Specifying &lt;p&gt; without the align attribute reset; 
= the line to left alignment. 

* ©param mode (MODE_WRAP, MODE_NOWRAP) Specifies text wrapping mode to use. If you 

iB specify nowrap, the device uses another mechanism, such as horizontal scrolling, to 

;il display long lines to the user. The device continues to use the mode you specify 

until you specify a &amp ; It ;p&;amp ;gt ; element with the other mode. 

hj public Paragraph (String align. String mode) 

thisO ; 

addAttribute( "align", align) ; 
addA 1 1 r ibut e ( " mode " , mode ) ; 
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package com . thinairapps . tag . wml ; 

import com . thinairapps . tag . Inval idTagExcept ion ; 

/** 

* The <option> tag element specifies a particular choice within a <i>select</i> tag 
element . 

*/ 

public class Option extends WMLTag 

public Option () { 

super ( "option" ) ; 

} 

/** 

* ©param value Specifies the value to assign to the variable defined in the <i>select</i \^ 

> tag 

* element name attribute if the user selects the option (see example) . If you specify a 

* variable reference, the device evaluates the reference before setting the name variable 

*/ 

public Option (String value) { 
thisO ; 

addAttribute ("value", value ) ; 

} 

/** 

* @param title A label that identifies the option. The UP. Browser uses the title as the 

* ACCEPT key label when the user selects the option. To ensure compatibility on a wide 
~4 * range of devices, label should be a maximum of five characters. 

* (gparam value Specifies the value to assign to the variable defined in the <i>select</i 

Ki * element name attribute if the user selects the option (see example) . If you specify a 

* variable reference, the device evaluates the reference before setting the name variablei/" 

*/ 

public Option(String title, String value) { 
this (value) ; 

addAttribute ("title", title) ; 



/** 

* @param title A label that identifies the option. The UP. Browser uses the title as the 

* ACCEPT key label when the user selects the option. To ensure compatibility on a wide 

* range of devices, label should be a maximum of five characters. 

* Oparam value Specifies the value to assign to the variable defined in the <i>select</i 

> tag 

* element name attribute if the user selects the option (see example) . If you specify a 

* variable reference, the device evaluates the reference before setting the name 

variable . 

* @param label the text to be used as the displayable option 

public Option(String title, String value. String label) { 
this (title, value); 
setLabel (label) ,- 

} 



/** 

* Oparam onPick Specifies the URL to open if the user selects the option (or deselects it 

* if the <i>select</i> element allows multiple choices) . This attribute represents an 

* abbreviated form of the &lt ,- one vent &gt ; element. 

public void setOnPick (String onPick) { 
addAttribute { "onpick" , onPick) ; 
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*@param label the text to be used as the displayable option 

public void setLabel (String label) throws InvalidTagException { 
addChild(new Text (label) ) ; 

} 

public void addChild { WMLTag child) throws InvalidTagException { 
if (child instanceof Text \ | child instanceof OnEvent) 
super .addChild (child) ; 

else 

throw new InvalidTagException ( "Option only supports Text or OnEvent children 
tags" ) ; 

} 
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package com. thinairapps . tag . wml ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* The <optgroup&:gt; element allows you to group multiple <option> (or nested 

* <optgroup> ) elements within a card. Creating option groups lets you specify control 

* information about how the device should present the card content . 

public class OptGroup extends WMLTag 

public OptGroup 0 { 

super ( " optgroup " ) ; 



/** 

* Oparam title Specifies a brief label for the &lt ;optgroupS;gt ; group. Some devices use 

* the label as a title when displaying the &lt ;optgroup&:gt ; content. Others might use it 

* as a label for a user interface mechanism that lets the user navigate to the 

* &lt ; optgroup&gt ; content . 
*/ 

public OptGroup (String title) { 
super ( "optgroup" ) ; 
addAttribute ( "title" , title) ; 

} 

/* 

*@param child a Tag of type Option or OptGroup 

public void addChild (WMLTag child) throws InvalidTagException { 
if (child instanceof OptGroup | | child instanceof Option) 
super. addChild (child) ; 

else 

throw new InvalidTagException ( "OptGroup only supports OptGroup or Option childreni^ 
tags" ) ; 
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package com. thinairapps . tag . wml ; 

import com . thinairapps . tag . Inval idTagException ; 

/** 

* The &lt,-onevent> element associates a state transition, or intrinsic event, with a task 

. When the 

* intrinsic event occurs, the device performs the associated <onevent> task, 
public class OnEvent extends WMLTag 

public final static String TYPE_ON_PICK = "onpick"; 

public final static String TYPE_ON_ENTER_FORWARD = "onenterforward" ; 
public final static String TYPE_ON_ENTER_BACKWARD = "onenterbackward" ; 
public final static String TYPE_ON_TIMER = "ontimer"; 

/** 

* ©param type Identifies the intrinsic event that triggers the specified <onevent> task ^ 

(see 

* descriptions below). If a card-level <onevent> element (i.e. defined within a <card> k? 

element) 

* has the same type as a deck-level <onevent> element (i.e. defined within a <template> 

element) , 

* the card-level binding overrides the deck-level binding. 

O public OnEvent (String type) { 
super ( "onevent ") ; 
addAttribute ( " type " , type ) ; 



public void addChild (WMLTag child) throws Inval idTagException { 
if (child instanceof Task) 
super. addChild (child) ; 

else 

throw new InvalidTagException( "OnEvent only supports Task children tags"); 
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package com. thinairapps . tag . wml ; 
/** 

* The <noopS:gt; element is a task element that instructs the device to do nothing, i.e ^ 

. "no operation. " 

* This element is useful for overriding deck-level <do> elements, called shadowing (see the 

UP . SDK ^ 

* Developer's Guide for more information on shadowing). 

public class NoOperation extends Task 

public NoOperation ( ) { 

super ( "noop" , false) ; 

} 

} 
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package com . thinairapps . tag . wml ; 
/** 

* An insertable space ( ) 
*/ 

public class NonBreakingSpace extends Text 

public NonBreakingSpace (int number) { 
super { " ) ; 

for (int i = 0; i < number; i++) 

setName (getName ( ) + " &nbsp ; " ) ; 

} ^ 
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package com. thinairapps . tag . wml ; 

import com . thinairapps . tag . Inval idTagExcept ion ; 

/** 

* A WML widget which creates a card with multiple <i>input</i> tags. The WAP 

* Browser will either display this as a single card with "popup" input 

* fields, or as multiple cards which the user steps through. 

public class MultiplelnputCard extends Card 

public MultiplelnputCard 0 { 
super ( ) ; 

} 

/**Constructs a new MultiplelnputCard with the given name (id) . 

* Oparam id specifies a name for the card 
*/ 

public MultiplelnputCard (String id) { 
super ( id) ; 

} 



* Oparam id specifies a name for the card 

* @param title specifies a brief label for the card 
*/ 

public MultiplelnputCard (String id, String title) { 
super (id, title) ; 

} 

/♦♦Constructs a new MultiplelnputCard with the given name (id) , label (title) and \e 
' newcontext ' attributes . 

* ©pararn id specifies a name for the card 

* ©pararn title specifies a brief label for the card 

* @param newContext specifies whether the device should initialize the context whenever 

the user naviages to the card through a &lt ;go/&gt ; task 

public MultiplelnputCard (String id, String title , boolean newContext) { 
super (id, title, newContext) ; 

} 

/♦♦Constructs a new MultiplelnputCard with the given name ('id'), label ^ 
{'title'), 'newcontext' attributes, 

♦ and 'ordered' attributes. 

♦ ©param id specifies a name for the card 

♦ @param title specifies a brief label for the card 

♦ ©param newContext specifies whether the device should initialize the context whenever 

the user naviages to the card through a Sit ; go/&gt ; task 

♦ ©param ordered specifies the organization of card content 
*/ 

public MultiplelnputCard (String id, String title , boolean newContext, boolean ordered) { 
^ super (id, title, newContext, ordered) ,- 

* @param href the url to pass the result of the form input to 

♦ ©param acceptLabel the text label to use on the accept button ("save", "submit", etc) 
*^@param method the method to use to submit the form data to the seirver ( "POST" , "GET" ) 

public void buildCard (String href , String acceptLabel , Labeledlnput [] inputs , String 
method) throws Inval IdTagException 

buildCard (null , href , acceptLabel , inputs , method) ; 
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public void buildCard (String header. String href, String acceptLabel , Labeledlnput [ ] 
inputs , String method) throws InvalidTagException 

^ buildCard {header, href, acceptLabel, inputs, method, null) ; 
/** 

* ©param header text to be displayed at the top of the form 

* ©pararn href the url to pass the result of the form input to 

* Oparam acceptLabel the text label to use on the accept button ("save", "submit", etc) 

* ©param method the method to use to submit the form data to the server (" POST" , "GET" ) 

public void buildCard (String header. String href, String acceptLabel, Labeledlnput [] 
^ inputs. String method, PostField[] hiddenFields) throws InvalidTagException 

Paragraph p = new Paragraph () ; 

boolean closingGo = false; 

if (method. equals (Go.METHOD_POST> ) 
closingGo = true,- 

Go gol = new Go (href, closingGo, method); 
Do dol = new Do (Do.TYPE_ACCEPT,gol) ; 

dol . addAttribute ( "label " , acceptLabel ) ; 

if (method. equals (Go. METHOD_POST) ) 

for (int 1=0; i < inputs .length; i++) 

gol .addChild(new PostField (inputs [i] . get InputName (),"$ " + inputs[i]. 
getlnputName 0 ) ) ; 

if (hiddenFields != null && hiddenFields . length > 0) 
for (int 1=0; i < hiddenFields . length; i+4) 
^ gol. addChild (hiddenFields [i] ) ; 

p.addChild(dol) ; 

if (header != null) 
{ 

p. addChild (new Text (header) ) ; 
p. addChild (new Break () ) ; 

} 

for (int i = 0; i < inputs . length; i++) 
p. addChild (inputs [i] ) ; 

addChild (p) ; 



} 
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package com . thinairapps . tag . wral ; 
/** 

* The <meta> element provides meta information for a WML deck. This element is 

specified 

* within the deck header along with any access control information for the deck (for mo: 

* information, see &lt ;access&gt ; element and &lt ;head&gt ; element). Note that not all 

devices 

* support every meta information type. 

public class Meta extends WMLTag 

public final static String PROPERTY_NAME = "name"; 

public final static String PROPERTY_HTTP_EQUIV = "http- equiv" ; 

public final static String PROPERTY_USER_AGENT = "user-agent " ; 

public final static String PROPERTY_USER_AGENT_MARKABLE = "vnd . up . markable " ; 
public final static String PROPERTY_USER_AGENT_BOOKMARK = "vnd.up.bookmark" ; 



* ©param propertyType the attribute name 1 

, etc) 

* ©param propertyValue the value for the ; 

* ©param content Specifies the metadata v; 
*/ 



: with this Meta tag (i.. 



http-equivi^ 



tribute indicated in propertyType 

ue associated with the property attribute. 



public Meta(String propertyType , String propertyValue, String < 
super ( "meta" , false) ; 

addAttribute (propertyType, propertyValue) ; 
addAttribute { "content" , content) ; 

) 

/* 

* @pa: 



intermediate agent must remove the <meta&gt ; 



I forua (true | false) Specifies that the author intended the property to reach \i 

the 

* user agent. If forua="falsi 

element 

* before the document is sent to the client. If the value is "true", the metadata of the 

* element must be delivered to the user agent. The method of delivery may vary. For 

example, 

*^http-equiv metadata may be delivered using HTTP or WSP headers. 



public void setForua (boole 
{ 

addAttribute ( "forua" , " 



. forua) 



/*See specific WAP browser documentation for info: 

* of the Meta tag. 

*/ 

public void setScheme (String scheme) 
addAttribute ( "scheme" , scheme) ; 



L about support for this 
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package com. thinairapps . tag . wml ; 

/** 

* An <input> tag with a text label next to it. See the Label class for more inf ormation>^' 
on the arguments . 

V 

public class Labeledlnput extends Input 
String label ; 

*^@param label the text label to use with this Input tag 

public Labeledlnput (String name, String label) { 
super (name) ; 
this. label = label; 



* @param label the text label to use with this Input tag 

public Labeledlnput (String name, String type, String format , String label) 

super ( name , type , format ) ; 
this. label = label; 

} 

/** 

*^@param label the text label to use with this Input tag 

public Labeledlnput (String name, String title, String type, String format , String value 
String defaultValue, String label) { 
super (name , title , type , format , value , defaultValue ) ; 
this. label = label; 

} 

/** 

* ©param label the text label to use with this Input tag 

public void setLabel (String label) { 
this. label = label; 

} 



public String render ( ) { 

return label + super . render () ; 
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package com. thinairapps . tag . wml ; 
/** 

* The <input> element lets the user enter text which the device assigns to a specified \^ 
variable . 

*/ 

public class Input extends WMLTag 

public final static String TYPE_TEXT ~ "text"; 

public final static String TYPE_PASSWORD = "password"; 

public final static String FORMAT_UCASE_ALPHA = "A"; 

public final static String FORMAT_LCASE_ALPHA = "a"; 

public final static String FORMAT_NUMERIC = "N" ; 

public final static String FORMAT_ANY_UCASE = "X"; 

public final static String FORMAT_ANY_LCASE = "x"; 

public final static String FORMAT_ANY_UCASE_CHANGEABLE = "M" ; 

public final static String FORMAT_ANY_LCASE_CHANGEABLE = "m" ; 

/** 

*@parain name The name of the variable in which the device stores the text entered by thei^ 
*/ 

public Input (String name) 

= :J super (" input ", false) ; 

addAttribute ( "name " , name) ; 

} 

/** 

*@param name The name of the variable in which the device stores the text entered by thei^ 
user. 

*@param title Specifies a brief label for the input item. Some devices use the label as ai^ 
tooltip when displaying the input field. Others might use it as a label for a user kT 
interface mechanism that lets the user navigate to the item. For example, if a device kT 
cannot display all card content on one screen' and ordered="true" (see Order 
options), the UP. Browser uses the title to identify this input item on a li- 
summary- level menu. 

*@param type (text | password) Specifies how the device should display text the user kT 
enters. Specifying type="text" causes the text to be visible. Specifying type wr 
="password" causes the text to be masked (for example, replaced by "*" characters) . 
Note that the password mode is not encrypted so you should not rely on it for 
securing critical data. 

*®param format Specifies a data format that the user entry must match (see Specifying a \^ 
format mask below) . If you omit this attribute, the device assumes *M (default 
uppercase first character followed by up to maxlength number of mixed case alphabetic 
and numeric characters) . 

*/ 

public Input(String name, String type, String format) { 
this (name) ; 

addAttribute ( "type" , type) ; 
setFormat (format) ; 

} 

/** 

*@param name The name of the variable in which the device stores the text entered by thei^ 
user. 

*@param title Specifies a brief label for the input item. Some devices use the label as a.^ 
tooltip when displaying the input field. Others might use it as a label for a user 1/ 
interface mechanism that lets the user navigate to the item. For example, if a device i^' 
cannot display all card content on one screen and ordered="true" (see Order k/ 
options), the UP. Browser uses the title to identify this input item on a 
summary-level menu. 

*@param type (text | password) Specifies how the device should display text the user y 
enters. Specifying type="text" causes the text to be visible. Specifying type 1^ 
= "password" causes the text to be masked (for example, replaced by "*" characters) . 
Note that the password mode is not encrypted so you should not rely on it for 1^ 
securing critical data. 

*@param format Specifies a data format that the user entry must match (see Specifying a ^ 
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format mask below) . If you omit this attribute, the device assumes *M (default \t 
uppercase first character followed by up to maxlength number of mixed case alphabetici^ 
and numeric characters) . 
*®param value Specifies the value of the variable named in the name attribute. When the \i 
element is displayed and the variable named in the name attribute is not set, the 
name variable is assigned the value specified in the value attribute. If the'name \^ 
^ variable already contains a value, the value attribute is ignored. 

public Input (String name, String title. String type. String format. String value, Strinqi^ 
defaultValue) 

{ 

this (name, type, format) ,- 
addAttribute( "title", title) ; 
addAttribute ( "value" , value) ; 
addAttribute ( "default" , defaultValue) ; 

} 

/** 

*@param type (text | password) Specifies how the device should display text the user 

enters. Specifying type="text" causes the text to be visible. Specifying type kC 
="password" causes the text to be masked (for example, replaced by characters) . 

Note that the password mode is not encrypted so you should not rely on it for 
securing critical data. 

*/ 

public void setType (String type) 
1 addAttribute ( "type" , type) ; 



*@param value Specifies the value of the variable named in the name attribute. When the ^ 

element is displayed and the variable named in the name attribute is not set, the <^ 

name variable is assigned the value specified in the value attribute. If the name ^ 
variable already contains a value, the value attribute is ignored. 

public void setvalue (String value) 

addAttribute ( "value" , value) ; 

} 

/** 

* ©pararn emptyOk (true | false) Specifies whether the user can leave the field blank. )^ 

Specifying 

* emptyok="true" indicates that the field is optional--if the user enters a value, ^ 

however, the 

♦^device applies any entry requirements you specify for the format attribute, 
public void setEmptyOk (boolean emptyOk) 
addAttribute ( "emptyok", «" + emptyOk); 



*@param format Specifies a data format that the user entry must match (see Specifying a 
format mask below) . 

*If you omit this attribute, the device assumes *M (default uppercase first character) . 
public void setFormat (String format) 
addAttribute ( "format" , format) ; 



*@param format Specifies a data format that the user entry must match (see Specifying ; 
format mask below) . 

*If you omit this attribute, the device assumes *M (default uppercase first character 

followed by up to 
*maxlength number of mixed case alphabetic and numeric characters) . 
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public void setFormat (String format, int max) 
addAttribute ( "format" , max + format); 

} 

/*Sets the 'size' attribute for the Input tag. 
*/ 

public void setsize (int size) 
{ 

addAttribute ( "size" " + size) : 

} 

/** 

*@param maxlength Specifies the maximum number of characters the user can enter. If 
do not specify the maxlength attribute, the UP. Browser imposes a limit of 256 
characters . 

*/ 

public void setMaximumLength (int maxLength) 
^ addAttribute { "maxLength", "" + maxLength); 

/*Sets the -tabindex' attribute for the Input tag. 

public void setTablndex (int tablndex) 
{ 

addAttribute ( "tabindex" , " " + tablndex) ; 

/♦Returns the name of this Input tag. 
*/ 

public String getlnputName ( ) 

return getAttribute ( "name" ) .getValueO ; 
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package com . thinairapps . tag . wml ; 
/** 

* The <image> element instructs the device to display an image within formatted text i^- 
Note that not all devices can display images. 

public class Image extends WMLTag 

public final static String ALIGN_TOP = "top"; 
public final static String ALIGN__MIDDLE = "middle" ; 
public final static String ALIGN_BOTTOM = "bottom"; 

/** 

*@param src The URL of the image to display. If you specify a valid icon for the localsrcKT 

attribute (see below), the device ignores this attribute. 
*©param alt Specifies the text to display if the device does not support images or cannot kT 

find the specified image. 

public Image (String src, String alt) { 
super ( "img" ) ; 
if (src != null) 

addAttribute ( "src" , src) ; 

else 

addAttribute ( "src " , " " ) ; 

13 if (alt != null) 

addAttribute ("alt", alt) ; 



addAttribute ( "alt " , " 



* Oparam icon A class representing a known icon. If the device cannot find the icon in 

ROM (Read-only Memory), it attempts to retrieve it from the UP. Link Server. If you 
specify a valid icon (see Figure 2-6 for a list of icon names), the device ignores 
the src and alt attributes (see above) even though they are still required. 

* (gparam align alignment of image with text (ALIGN_TOP, ALIGN_MIDDLE , ALlGN_BOTTOM) 

* (Sparam alt Specifies the text to display if the device does not support images or 

cannot find the specified image. 

public Imagedcon icon, String align, String alt) ( 
this (null, alt) ; 

addAttribute("localsrc",icon.getLocalSrc() ) ; 
addAttribute ("align" , align) ; 



* ©param height the desired scaled height of the image 
*^@param width the desired scaled width of the image 

public void setSizednt height, int width) 

addAttribute (" he ight ", + height); 
^ addAttribute ( "width" ," " + width); 

/** 

* @param vspace the amount of space above and below the image 
*^@param hspace the amount of space to the left and right of the image 

public void setSpace(int vspace, int hspace) 

addAttribute ( "hspace" ," " + hspace); 
^ addAttribute ( "vspace" ," " + vspace); 
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package com. thinairapps . tag . wml ; 
/** 

* A utility class which represents the static strings used for indicating the names 

* of the built-in icons which some WAP phones support for use with the Image tag. Consult 

* the documentation for specific WAP browsers for more information. 

public class Icon 
{ 

private String localSrc = null; 
/** 

* ©param localSrc the local icon name to be used 
*/ 

public Icon (String localSrc) 
this .localSrc = localSrc; 

} 

public String getLocalSrc ( ) { 
return localSrc; 

} 

public final static String EXCLAMATIONl = "exclamationl " ; 
public final static String EXCLAMATION2 = " exclamation2 " ; 
Ij public final static String QUESTIONl = "questionl " ; 
public final static String QUESTI0N2 = "question2"; 

public final static String MAILBOX = "mailbox"; 

public final static String MAGMIFY_GLASS = "magnif yglass " ; 

public final static String LOCK_KEY = "lockkey"; 

■ ■ public final static String INBOX = "inbox"; 
public final static String OUTBOX = "outbox"; 

public final static String FOLDER_CLOSED = "folderl"; 
- " public final static String FOLDER_OPEN = "folder2"; 

■ public final static String CLOCK = "clock" ; 

public final static String PUSHPIN = "pushpin"; 

public final static String DOCUMENTl = "documentl"; 

public final static String FLOPPY_DISK = "floppyl"; 

public final static String CHECKMARKl = "checkmarkl " ; 

public final static String PHONE_OLD = "phonel"; 
public final static String PHONE_HANDSET = "phone2"; 
public final static String PHONE_MOBILE = "phone3"; 

public final static String ENVELOPEl = "envelopel"; 
public final static String ENVEL0PE2 = "envelope2"; 

public final static String PAPERCLIP = "paperclip"; 

public final static String PENCIL = "pencil "; 

public final static String ROLOCARD = "rolocard"; 

public final static String CALENDAR_MONTH = "calendar"; 
public final static String CALENDAR_DAY = "day"; 
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package com . thinairapps . tag . wml ; 

import com . thinairapps . tag . Inval idTagExcept ion ; 

/** 

* The £=lt;head> element specifies information about the deck as a whole, includinq 
metadata and access control information. 

*/ 

public class Head extends WMLTag 

public HeadO { 

super ( "head" ) ; 

} 

/** 

* oparam child a Tag to be added to this FieldSet . 

* ©exception com. thinairapps . tag. InvalidTagException if the tag is not an instanc« 

subclass of classes Access or Meta. 

*/ 

public void addChi Id (WMLTag child) throws InvalidTagException { 
if (child instanceof Access | | child instanceof Meta) 
super. addChild (child) ; 

else 

throw new InvalidTagException ( ) ; 
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package com . thinairapps . tag . wml ; 

import com . thinairapps . tag . Inval idTagException ; 

/** 

* The <go> element is a task element that instructs the device to open a specified URL ^ 
. If the URL specifies a particular card, the device displays that card. If the URL v! 
^ specif xes a deck, the device displays the first card in that deck. 

public class Go extends Task 
{ 

public final static String METHOD_GET = "get"; 
public final static String METHOD_POST = "post"; 

public final static String CHARSET_DEFAULT = "UTF-8"; 

/***Constructs a standard Go Tag with the appropriate URL. 

* ©param href The URL to which this Task should link 

*^@param closed a boolean indicating if there are to be children Tags 

public Go (String href, boolean closed) { 

super ("go", closed) ; 

addAttribute ( "href " , href ) ; 
^ addAttribute ( "sendreferer" , "true") ; 

/***Constructs a standard Go Tag with the appropriate URL and link method. 

* ©pararn href The URL to which this Task should link 

* ©param closed A boolean indicating if there are to be children Tags 
*^@param method This should be either ' Go . METHOD_GET ' or "Go .METHOD_POST" 

public Go (String href, boolean closed, String method) { 

super ( "go" , closed) ; 

addAttribute ( "href" , href) ; 

addAttribute ( "method" , method) ; 
^ addAttribute ("sendreferer", "true") ; 

/***Constructs a Go Tag with the appropriate URL and link method. 

* Oparam href The URL to which this Task should link 

* ©pararn closed A boolean indicating if there are to be children Tags 

* ©param sendReferrer A boolean indicating if there deck URL should be included in the 

URL request 

* ©param method This should be either ' Go . METHOD_GET ' or "Go.METHOD_POST" 

* ©paran acceptCharset Specifies the device encoding you application can handle in a ^ 

comma or space 

* delimited list, such as "UTF-8, US-ASCII, ISO, 8859-1" 
*/ 

public Go (String href, boolean closed, boolean sendReferer, String method. String i^' 
acceptCharset) { 
this (href , closed) ; 

addAttribute ( "sendreferer" , " " + sendReferer) ; 
addAttribute ( "method" , method) ; 
^ addAttribute ( " accept - charset " , acceptCharset ) ; 

/***Adds a PostField to this Go task. 
*/ 

public void addPostField (PostField postfield) throws InvalidTaqException ( 
^ addChild(postf ield) ; 

/***Adds a PostField to this Go task with the specified value pre-set. 

public void addPostField (String name, String value) throws Inval idTagException { 
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addPostField{new PostField (name, value) ) ; 
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package com. thinairapps . tag . wml ; 

import com. thinairapps. tag. InvalidTagException; 

/** 

* The <fieldset> element allows you to group multiple text or input items within a cardwr 

. Specifying 

* °"in°order^to'^'''^'"^'^'^^^^^^*'' ^^^^ control how the device presents card content 

* simplify user navigation. 
*/ 

public class FieldSet extends WMLTag 

public FieldSet () { 

super ( " f ieldset " ) ; 



* WAP browser documentation for more details. 
*/ 

public FieldSet (String title) { 
thisO ; 

^ addAttribute C "title" , title) ; 
/** 

* ©param child a Tag to be added to this FieldSet. 

* ©exception com. thinairapps . tag. invalidTagException if the tag is not an instance or ^ 
^ subclass of classes Text, FieldSet, Input, or Select. 

public void addChi Id (WMLTag child) throws InvalidTagException { 

if (child instanceof Text | | child instanceof FieldSet | | child instanceof Input I i ^ 
child instanceof Select) 
super. addChild (child) ; 

else 

throw new InvalidTagException () ; 
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package com. thinairapps . tag. wml ; 

import com. thinairapps . tag . InvalidTagException; 
/** 

* The <do> element associates a task with an element within the user interface {for ^ 

example, a v wj. ^ 

* function key, graphically- rendered button, or voice-activated command) . When the user 

invokes the 

*^user interface mechanism, the device performs the associated <do> element task, 
public class Do extends WML Tag 

public final static String TYPE_ACCEPT = "accept"; 

public final static String TYPE_DELETE = "delete", - 

public final static String TYPE_HELP = "help"; 

public final static String TYPE_OPTIONS = "options"; 

public final static String TYPE_PREV = "prev" ; 

public final static String TYPE_RESET = "reset"; 

public final static String TYPE_UNKNOWN = ""; 

/** 

* @param type Identifies the generic user interface mechanism that triggers the specifiedi^ 

Sclt;dO> 

* element task (see descriptions below) . 
*^®param task Task tag to added as child 

public Do (String type. Task task) throws InvalidTagException { 
super ( "do" ) ; 

addAttribute ( "type" , type) ; 
addChild(task) ; 

} 

/** 

* ©param type Identifies the generic user interface mechanism that triggers the specified^ 

<do> 

* element task (see descriptions below) . 

* ©param task Task tag to added as child 

* ©param label A label that identifies the task with the user interface mechanism For ^ 

example, if 

* you bind a task to the ACCEPT key, the device displays this value as the function kev ^ 

label. If ^ 

* ^°ACCEPT°key^^°'^^^ ^^^^^ attribute, the device uses the word "OK" as the default kT 

* """^five ensure compatibility on a wide range of devices, label should be a maximum ofx' 

* characters. Devices ignore the label attribute if they do not support dynamic labelling^ 

* ©param name Specifies a name for the <do> element. If a card- level <do> ^ 

element (i.e. , a , .c 

* "^^elem*^ within a &lt ; cards=gt ; element) has the same name as a deck-level <do> i^- 

* defined within a <template> element), the card-level binding overrides the ^ 

deck- level binding. 
^* ©param optional Specifies whether the device can ignore this element. 

public DO (String type, Task task, String label. String name, boolean optional) throws ^ 
InvalxdTagExceptxon { 
this (type, task) ; 
addAttribute ("label", label) ; 
addAttribute ( "name" , name) ; 
addAttribute ( "optional" , " " + optional) ; 



/ 

* element task. This should be one of the type constants defined in this class 



* ®P^^^'^^^ype Identifies the generic user interface mechanism that triggers the specif ied.^' 



C: \TASS\ThinAirServer\Platf orm\ . . \com\thinairapps\tag\wTnl\Do. java 



2 



* ©pararn task Task tag to added as child 

* Oparam label A label that identifies the task with the user interface mechanism. For ^ 

example, if 

* you bind a task to the ACCEPT key, the device displays this value as the function key ^ 

label. If 

* you do not specify the label attribute, the device uses the word "OK" as the default 

ACCEPT key 

* label. To ensure compatibility on a wide range of devices, label should be a maximum of 

five 

* characters. Devices ignore the label attribute if they do not support dynamic labellingi^ 

* ©param name Specifies a name for the <do&:gt; element. If a card-level <do> 

element (i.e. 

* defined within a &lt ;card&gt,- element) has the same name as a deck- level <do> 

element {i.e. 

* defined within a &:lt ; template&gt ; element), the card-level binding overrides the 

deck-level binding. 

* @param optional Specifies whether the device can ignore this element. 

public Do (String type, Task task. String label, boolean optional) throws <^ 
InvalidTagException { 
this (type, task) ; 
addAttribute (" label ", label ) ; 
addAttribute ( "optional" , "false") ; 
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package com . thinairapps , tag . wml ; 

import com. thinairapps . tag . InvalidTagException ; 

/** 

* f link "^^""^ extends Card and providers basic functionality for displaying a message and 
*/ 

public class DisplayCard extends Card 

public DisplayCard ( ) 
super ( ) ; 



/**Constructs 



name ('id') attribute 



*^@param id specifies a name for the card 
public DisplayCard (String id) 



/**Constructs a new Card with the given name ('id') and label ('title') attribute. 

* Oparam id specifies a name for the card 
*^@param title specifies a brief label for the card 

public DisplayCard (String id, String title) 

super (id, title) ; 

^**'^attribStes^ "^^"^ ^^""^ ^^^^ ^^^^"^ '"^"'^ ('id'), label ('title') and ' newcontext ' 

* @param id specifies a name for the card 

* ©param title specifies a brief label for the card 

* ©param newContext specifies whether the device should initialize the context whene. 

the user naviages to the card through a <go/> task 

public DisplayCard (String id, String title , boolean newContext) 
super (id, title, newContext) ; 



* ©param id specifies a name for the card 

* ©param title specifies a brief label for the card 

* ©param newContext specifies whether the device should initialize the context whenever 

the user naviages to the card through a <go/> task 
*^@param ordered specifies the organization of card content 

public DisplayCard (String id, String title , boolean newContext , boolean ordered) 

^ super (id, title, newContext , ordered) ; 

* ©param text the text you wish to display 

* '^CEN?ESlLagL^h'S? "''^"■^^"^ '° ^^^^ (Paragraph. LEFT, Paragraph, 
public void buildCard (String text. String align) 
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Paragraph p = new Paragraph (align , Paragraph . MODE WRAP) - 
p.addChild (new Text(text)); 
addParagraph (p) ; 



/** 

* (Sparam text the text you wish to display 

* ®P^^f™ ^^^9" paragraph alignment to use for the next (Paragraph. LEFT, Paragraph 

CENTER, Paragraph. RIGHT) ^j-ay xapri . 

*^@param href the url to use with the "Ok" link on the Card 
public void buildCard (String text. String align. String href) 

try { 

addChild(new Do (Do . TYPE_ACCEPT, new Go (href , false) )) ; 
Paragraph p = new Paragraph (align, Paragraph .MODE WRAP) ; 
p.addChild(new Text (text) ) ; ~ 
addParagraph (p) ; 

catch (InvalidTagException e) { 
e . printStackTrace ( ) ; 



* @param text the text you wish to display 

* ^1^9=^ paragraph alignment to use for the next (Paragraph. LEFT, Paragraph ^ 
CENTER, Paragraph. RIGHT) a i c^y j. ^pii . kr 

* ©param href the url to use with the "Ok" link on the Card 

* ®^!uses^setSn?imer(^r''''^ ^^"^ ^""^^ ^^""^ ^^^^^^ automatically loaded ^ 
public void tauildCard (String text, String align. String href, int seconds) 

Paragraph p = new Paragraph (align, Paragraph. MODE WRAP) ; 

Timer timer = new Timer (seconds) ; 

setOnTimer (href ) ; 

p.addChild (timer) ; 

p.addChild (new Text (text) ) ; 

addParagraph (p) ,- 
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package com. thinairapps . tag . wtnl ; 
/** 

* A utility class solely used to group sets of WMLTags together for rendering. This is nr 

public 

* class as an implementaion detail. Do not use this class in your applications. 
*/ 

public class Container extends WMLTag 

public Container 0 { 
super (" " , false) ; 

} 

public String render () { 

return renderChildren ( ) ; 
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package com. thinairapps . tag . wml ; 
import com. thinairapps. tag. * ; 

* A non-rendered portion of the page used to contain any extraneous information desired by kf 
the developer 

*/ 

public class Comment extends WMLTag { 

/**Constructs a Comment with the given String. 

* (Sparam text the comment to be added to the WML Deck 
*/ 

public Comment (String text) { 

super ("!-- " + text + " false); 
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package com . thinairapps . tag . wml ,- 

import com. thinairapps . tag . InvalidTagException; 

/** 

* A WML deck consists of one or more &lt ;card&gt ; elements, each of which specifies 

* a single interaction between the user and the device. 
*/ 

public class Card extends WMLTag 

public CardO { 

super ( "card" ) ; 

} 

/**Constructs a new Card with the given name (id) . 

* ©param id specifies a name for the card 
*/ 

public Card(String id) { 
thisO ; 

addAttribute { "id" , id) ; 

} 

/**Constructs a new Card with the given name ('id') and label ('title') attributes. 

* ©param id specifies a name for the card 

* ©param title specifies a brief label for the card 
*/ 

public Card(String id, String title) { 
this (id) ; 

addAttribute ("title" , title) ; 

} 



/**Constructs a new Card with the given name (id), label (title) and 'newcontext' i^" 
attributes . 

* ©param id specifies a name for the card 

* ©param title specifies a brief label for the card 

* ©param newContext specifies whether the device should initialize the context whenever 

the user naviages to the card through a <go/> task 

*/ 

public Card(String id, String title, boolean newContext) { 
this (id, title) ; 

addAttribute ( "newcontext" ," " + newContext); 

} 

/**Constructs a new Card with the given name ('id'), label ('title'), 'newcontext' wT 
attributes, 

* and 'ordered' attributes. 

* ©param id specifies a name for the card 

* ©param title specifies a brief label for the card 

* ©param newContext specifies whether the device should initialize the context whenever kT 

the user naviages to the card through a <go/S:gt,- task 

* ©param ordered specifies the organization of card content 
*/ 

public Card(String id, String title, boolean newContext , boolean ordered) { 
this (id, title, newContext) ; 
setOrdered (ordered) ; 

} 

/**This attribute has different effects on different browsers. Consult your WAP browser 

* documentation for information about how ordered and unordered Cards are rendered. 

* ©param ordered specifies the organization of card content. 
*/ 

public void setOrdered (boolean ordered) { 
addAttribute ( "ordered" ," " + ordered); 



C:\TASS\ThinAirServer\Platfonn\ . . \com\thinairapps\tag\wml\Card. java 



2 



/** 

* ©param url specifies the URL to open if the user navigates to this card through a < 

go&gt ; task 

*/ 

public void setOnEnterForward (String url) { 
addAttribute ( "onenterf orward" ,url) ; 

} 

/** 

* @param url specifies the URL to open if the user navigates to this card through a < 

prev&gt ; task 

*/ 

public void setOnEnterBackward (String url) { 
addAttribute ( "onenterbackward" , url ) ; 

} 

/** 

* @param url specifies the URL to open if a specified alt ; timer&gt ; element expires 

public void setOnTimer (String url) { 
addAttribute ( "ontimer" ,url) ; 

} 

/**Adds a Paragraph to this Card. 

* @param p Paragraph tag to be added 
*/ 

public void addParagraph (Paragraph p) { 
try { addChild(p) ; } 
catch (InvalidTagException e) { 
e.printStackTraceO ; 



/** 

* ©param child WMLTag to be added 
*/ 

public void addChild(WMLTag child) throws InvalidTagException { 

if ( ! (child instanceof OnEvent | | child instanceof Timer | | child instanceof Do | | 
child instanceof Anchor | | child instanceof FieldSet | | child instanceof Image 
I I child instanceof Input | | child instanceof Select j | child instanceof 
Paragraph | j child instanceof Container) ) 
throw new InvalidTagException (" invalid child tag"); 

else 

super. addChild (child) ; 

} 
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package com. thinairapps . tag . wtiil ; 

* The &lt ;br/S:gt ; element specifies a line break. For example, it causes the device to ^ 
display the subsequent text or image on a new line. 

*/ 

public class Break extends WMLTag 
{ 

public Break 0 
{ 

super ("br", false); 

} 

} 
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package com. thinairapps . tag . wml ; 
/** 

* The <b> element specifies bold text. 
*/ 

public class Bold extends WMLTag 
{ 

/**Constructs an empty Bold tag. 
*/ 

public BoldO 

super ( "b" , true) ; 



/**Constructs a Bold tag with the given WMLTag as a child. 
*/ 

public Bold (WMLTag tag) 
this () ; 

addChild(tag) ; 



/**Constructs a Bold tag with the given Text tag as a child. 
*/ 

public Bold (String text) 
'~i this (new Text (text) ) ; 
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package com. thinairapps . tag . wml ,- 

import com. thinairapps . tag .Attribute ; 

import com. thinairapps . tag . InvalidTagException ; 

import java .util . Enumeration ; 



* anchor element: The &lt ; anchor&gt ; element anchors a task to a string of formatted text, 
often called a link. You can specify a link within any formatted text or image. When a 
user selects the link and presses ACCEPT, the device executes the task. 

*/ 

public class Anchor extends WMLTag 
{ 

/** 

* ©param task represents the action to perform when the user activates the link and text 

is the text the device will display to represent the link. You must anchor one of thei^ 
following task elements to a link: &lt ;goSegt ; , &lt ;prev&gt ; , &lt ; ref resh&gt ; , < kT 
Spawn>, <exit> , &lt ; throw S:gt 

* @param text Devices typically set this text off from surrounding text, for instance, 

by enclosing it in square brackets (see example) or underlining it if the device can 
display bitmap images. 

*/ 

public Anchor (Task task. Text text) 
( 

super ("anchor") ; 
addChild(task) ; 
addChild(text) ; 

} 

/** 

* oparam task represents the action to perform when the user activates the link and text 

is the text the device will display to represent the link. You must anchor one of thei^ 
following task elements to a link: &lt /go&gt ; , <prev> , &lt ; ref resh&gt ; , < \t 
spawn&gt , &lt ; exit&gt ; , &;lt ; throw&gt ; 

* ©param text Devices typically set this text off from surrounding text, for instance, byi^ 

enclosing it in square brackets (see example) or underlining it if the device can 
display bitmap images . 

* ©param title A label that identifies the link. If you do not specify the title ^ 

attribute, the device uses the word "Link" as the default label. 

*/ 

public Anchor (Task task, Text text, String title) { 
this (task, text) ; 
addAttribute ( "title" , title) ; 

} 

* ©param href url link for action 

* ©param title title displayed on button when selected 

* ©param generally child text to display as link 
*/ 

public Anchor (String href, String title, WMLTag child) { 
super ( "a") ; 

addAttribute ( "href href ) ; 
if (title != null) 

addAttribute ("title", title) ; 
addChild (child) ; 

} 

/** 

* Used to add a child tag to this Anchor object. 

* ©param child A WMLTag object to add as a child of this tag 
*/ 

public void addChild (WMLTag tag) { 
try { super. addChild (tag) ; } 
catch (InvalidTagException e> { 
e.printStackTraceO ; 

} ^ 
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protected String renderOpenTag ( ) { 

StringBuffer output = new StringBuf f er ( ) ; 

//render self open 
output . append { " < " ) ; 
output. append (name) ; 

Enumeration eAttribs = attributes . elements () ; 



while (eAttribs -hasMoreElements ( ) ) 

output . append { " " + ( (Attribute) eAttribs .nextElement ()). render ()) ; 

output . append ( " > " ) ; 

return output .toString () ; 

} 

protected String renderChildren { ) { 

StringBuffer output = new StringBuf fer () ; 

Enumeration eChildren = children . elements () ; 

while (eChildren. hasMoreElements (> ) 

output . append ( ( (WMLTag) eChildren . nextElement ( ) ) . render () ) ; 

return output . toString () ,- 

} 

protected String renderCloseTag ( ) { 
if (closingTag) 

return "</" + name + ">"; 
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package com. thinairapps . tag . wml ; 
/** 

* The <access&gt ; element specifies access control information for a WML deck. 

* You must specify this element within the deck header along with any meta 

* information for the deck (for more information, see &lt,-head> element and 

* <meta> element). Each deck can have only one &lt,-access&gt,- element. All 

* WML decks are public by default. 
*/ 

public class Access extends WMLTag 
{ 

public Access ( ) { 

super ( "access" , false) ; 

} 

/** 

* (Sparam domain The URL domain of other decks that can access cards in the 

* deck. The default value is the domain of the current deck. 
*/ 

public void setDomain ( String domain) { 
addAttribute ( "domain" , domain) ; 

} 

/** 

* ©param path The URL root of other decks that can access cards in the deck. 

* The default value is "/" (the root path of the current deck) which lets any 

* deck within the specified domain access this deck. 
*/ 

public void setPath (String path) { 
addAttribute ( "path" ,path) ; 

::f } 
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package com. thinairapps . tag . wml .goWebRim; 

import com . thinairapps . tag . wml . * ; 

/** 

* The &lt ;input> element lets the user enter text which the device assigns to a specified 
variable. 

*/ 

public class TextArea extends WMLTag 
{ 

public final static String TYPE_TEXT = "text"; 

public final static String TYPE_PASSWORD = "password"; 

public final static String FORMAT_UCASE_ALPHA = "A"; 

public final static String FORMAT_LCASE_ALPHA = "a"; 

public final static String FORMAT_NUMERIC = "N" ; 

public final static String FORMAT_ANY_UCASE = "X"; 

public final static String FORMAT_A!SrY_LCASE = "x" ; 

public final static String FORMAT_ANY_UCASE_CHANGEABLE = "M" ; 

public final static String FORMAT_ANY_LCASE_CHANGEABLE = "m"; 

public TextArea (String name] 



/** 

* @param name the unique id of this element 

* Oparam rows the number of rows 

* (Sparam cols the number of columns 
*/ 

public TextArea (String name,int rows,int cols) 
super ( "textarea" , true) ; 
addAttribute ( "name" ,name) ; 

addAttribute ( " rows " , " " + rows) ; 
addAttribute ( "cols" ," " + cols); 

} 



* ©param text set the text value for this elei 
*/ 

public void setValue (String text) { 

getChildrenO . removeAllElements ( ) ; 
getChildren ( ) . addElement (new Text(text)) ; 

} 
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package com. thinairapps .tag .wml .goWebRitn; 
/** 

* An &lt ; input&gt ; tag with a text label next to it. See the Label class for more inf ormationi/ 

on the arguments. 

* This class is to be used with the Go Web browser. 
*/ 

public class LabeledTextArea extends TextArea 
{ 

String label ; 
/** 

* @param label the text label to use with this TextArea tag 
*/ 

public LabeledTextArea (String name, String label) { 
super (name) ; 
this. label = label; 

} 

/** 

* @param label the text label to use with this TextArea tag 
*/ 

public LabeledTextArea (String name,int rows , int cols, String label) 
{ 

super (name , rows , col s ) ; 
=.' this, label = label; 

} 

/** 

* @param label the text label to use with this Input tag 
*/ 

public void setLabel (String label) { 
this. label = label; 

. ■ } 

public String getLabelO { 
} 

public String render () { 

return label + super. render () ; 
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package com . thinairapps . tag ; 
/** 

* The Attribute class is used to store all name/value pairs within a Tag object. This 

represents 

* a standard XML attribute 
*/ 

public class Attribute 
{ 

String name; 
String value; 
boolean useQuotes; 

private static final String NO_NAME = "_NONE"; 
/** 

* ©param name The attribute name 

* ©param value The attribute value 

* @param useQuotes determines whether the value should be surrounded by quotation marks 

public Attribute (String name. String value, boolean useQuotes) 

this. name = name; 

this. value = value; 

this .useQuotes = useQuotes; 

} 

/** 

* @param name The attribute name 

* @param value The attribute value 
*/ 

public Attribute (String name, String value) 
{ 

this (name, value, true) ; 

} 

/** 

* @param value A standalone value to be used within a tag. The name defaults to 

* • _NONE ' . 
*/ 

public Attribute (String value) 
this (NO NAME, value, false) ; 

} 

/** 

* ©return the attribute name 
*/ 

public String getName ( ) 
{ 

return name; 

} 

* ©return the attribute value 
*/ 

public String getValue ( ) { 
return value; 

} 

* ©return a string object representing the fully rendered text for this attribute 

public String render ( ) 
{ 

i f ( name . equal s ( NO_NAME ) ) { 
return value; 

} 

else { 



C: \tas_source\ThinAirServer\ . . \com\thinairapps\tag\Attribute .Java 
if (useQuotes) 



C:\tas_source\ . AcomXthinairappsXtagXlnvalidTagException. java 1 

package com.thinairapps.tag; 
/** 

* This runtime expection is thrown when addChildO is called, and passed a tag which 

* the class doesn't support as a child tag 

public class InvalidTagException extends Runt imeExcept ion 
/** 

* @param message text to display for this exception 
public InvalidTagException (String message) 
super (message) ; 

} 

/** 
*/ 

public InvalidTagException ( ) 

super ("invalid tag used"); 

} 

} 
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package com. thinairapps . tag ; 

import java .util .Enumeration; 
import java .util .Hashtable; 
import java .util .Vector ,- 

* This class is the basic Tag class used to implement all 

* other Tag elements. It can be extended to implement a new markup 

* language. A Tag can have any number of Attributes, be standalone 

* or paired, and have a hierarchy of children Tags. 
*/ 

public class Tag 
{ 

public String name; 
public Hashtable attributes; 
public Vector children; 
public boolean closingTag; 

/** 

* A constructor which creates a tag with the given name, and which may either be \^ 

standalone or a pair. 

* Oparam name the text to use for this tag (i.e. 'body' would be the value for <body&>^ 

gt;) 

* ©parara closingTag indicates whether this tag has a paired closing tag or is standalone 

public Tag (String name, boolean closingTag) 

this. name = name ; 
attributes = new Hashtable (); 
children = new Vector (); 
this .ClosingTag = closingTag; 



/** 

* A constructor which creates a paired tag set with the given name. 

* @param name the text to use for this tag (i.e. 'body' would be the value for ilt ;bodyS:i^' 

gt;) 

*/ 

public Tag (String name) 
{ 

this (name, true) ; 

} 

/** 

* ©return name of this tag 
*/ 

public String getName () 
{ 

return name; 

} 

/** 

* Oreturn Vector of all child tag of this tag. Note that the children themselves may be \^ 

parent nodes. 

*/ 

public Vector getChildren ( ) 
{ 

return children; 

} 

/** 

* @return A Hashtable of all attributes for this tag 

public Hashtable getAttributes ( ) 
{ 
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return attributes; 

} 

/** 

* ©return indicated whether this Tag has a closed pair or is open and standalone 
public boolean isClosedTag ( ) 

return this . closingTag; 

/** 

* Sets the name of this tag, after it has been constructed. 

* @param name the text to use for this tag (i.e. 'body' would be the value for <body&iir 

gt;) 

*/ 

public void setName (String name) 
} 

/** 

* Used to add an attribute object to this tag 

* @param attrib The attribute object to add to this tag 

public void addAttribute (Attribute attrib) 
{ 

attributes .put (attrib. getName ( ) , attrib) ; 

/** 

* Used to add an attribute, in the form of a name/value pair, to this tag 

* @param name the attribute name 

* ©parara value the attribute value 
*/ 

public void addAttribute (String name, String value) 
addAttribute (new Attribute (name , value) ) ; 

) 

/** 

* Used to retrieve an existing attribute for this tag object 

* ©param name the name of the attribute object to retrieve 

* ©return an attribute object corresponding to the name value passed; will be NULL if 

attribute doesn't exist 

*/ 

public Attribute getAttribute (String name) 
return (Attribute) attributes .get (name) ; 



/** 

* Used to add a child tag to this tag object. Intended for use only 

* with paired or "closed" tags, but won't throw an exception either 

* way. Tag never throws an InvalidTagException, but classes which 

* extend Tag may to enforce restrictions of certain markup languages. 

* @param child A Tag object to add as a child of this tag 
public void addChild (Tag child) throws InvalidTagException 

children. addElement (child) ; 

} 

/** 
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* Clears all child tags from this tag. 
*/ 

public void clearChildren ( ) 
{ 

children. removeAlIElements ( ) ; 

} 

/** 

* This method is currently not implemented. The goal of it is however to 

* allow a markup language text to be passed to it, and have a complete object 

* hierarchy be created- similar to an XML DOM Parser. 
*/ 

public void parse (String fullTagText) 



* This method is intended to be used as a way of creating a tag less version 

* of a tag hierarchy. For instance, you may create a complete HTML Tag hierarchy 

* of a webpage, either directly or through parsing, and then want just the text 

* content from that page for display on a WAP Phone or Pager. 

* @return only "intra-tag" text content for itself, and all subtags . 
public String getTextOnly ( ) 

Enumeration eChildren = children. elements {) 

StringBuffer text = new StringBuf f er ( ) ; 

while (eChildren . hasMoreElements ( ) ) 

text .append( ( (Tag) eChildren. nextElement {)) -getTextOnly ( ) + " " ) ,- 

return text . toString ( ) ; 

} 

/** 

* Renders opening tag, if a paired set, or the only tag if otherwise. All 

* attributes are also rendered as part of this Tag. 

* ©return formatted markup content of opening tag 
protected String renderOpenTag ( ) 

StringBuffer output = new StringBuf fer () ; 

//render self open 
output . append ( " < " ) ; 
output. append (name) ; 

Enumeration eAttribs = attributes . elements () ; 

while (eAttribs . hasMoreElements ( ) ) 

output . append ( " " + ( (Attribute ) eAttribs . nextElement ()). render ()) ; 

output . append (" >\n" ) ; 

return output . toString {) ; 

/** 

* Loops through all children Tag objects and calls their render ( ) methods, 

* which, if parent tags themselves, would cause them to render ( ) their children. 



* ©return formatted markup text of all child Tags of this Tag 
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*/ 

protected String renderChildren ( ) 

StringBuffer output = new StringBuf f er ( ) ; 

Enumeration eChildren = children. elements () ; 

while (eChildren. hasMoreElements ( ) ) 

output . append { ( (Tag) eChildren . nextEleraent ( ) ) . render { ) ) ; 

return output . toSt ring () ; 

/** 

* Renders closed tag, if paired set, otherwise returns empty String 

* @return formatted markup text of closing tag, or emtyp String if no closingTag 

protected String renderCloseTag ( ) 

if (closingTag) 

return "</" + name + ">"; 

else 

} 

/** 

* Returns the markup String for this Tag and all of its children. 

* ©returns formatted markup text of this tag, all attributes, and all child tags. 

public String render {) 
{ 

StringBuffer output = new StringBuf far ( ) ; 
output . append (renderOpenTag { ) ) ; 
output .append (renderChildren 0 ) ; 
output . append (renderCloseTag ( ) ) ; 
return output . toString () ; 
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package com. thinairapps . tag ; 
/** 

* @ ( # ) TagDocument . j ava 

* This abstract class functions as the container for all tag-based documents. It is 

extended by 

* classes like WMLTagDocument HDMLTagDocument , and HTMLTagDocuraent to implement the 

specifics of 

* each document type. 

* <p> 

* In general, you will only want to use this class directly when implementing connectors 

that render 

* more than one type of markup. This class gives you a means of having a reference to a 

TagDocument without 

* concerning yourself the type of browser to which the document is to be rendered. When 

rendering for only one 

* browser, you can just use HTMLTagDocument , WMLTagDocument, etc. directly. 

* </p> 
*/ 

public abstract class TagDocument 
{ 

private String location; 
private Tag root ; 
private String contentType; 
private String docType; 

- /** 

* Primary constructor used to build a specific type of TagDocument hierarcy. 

* Oparam rootTag the name of the root document tag. {i.e. "HTML" for a webpage, or 

"WML" for a WAP Deck) 

* ©param contentType the MIME content-type associated with the markup language being 

generated. 

* ©param closed indicates whether the root tag is opened, or closed/paired. 

public TagDocument (String rootTag, String contentType, boolean closed) 

root = new Tag (rootTag, closed) ; 
this. contentType = contentType; 

/** 

* Primary constructor used to build a specific type of TagDocument hierarcy. 

* Assumes that the root tag is a paired or closed. 

* Oparam rootTag the name of the root document tag. (i.e. "HTML" for a webpage, or 

"WML" for a WAP Deck) 

* ©param contentType the MIME content-type associated with the markup language being 

generated . 

*/ 

public TagDocument (String rootTag, String contentType) 
this{rootTag, contentType, true) ; 

/** 

* Sets the root node to a new Tag object. 

* ©param root The Tag object to use as the root tag for this document, 
public void setRoot (Tag root) 

this. root = root; 

} 

/** 

* Gets the root Tag object for this document. 

* ©return The root Tag object for this document. 
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*/ 

public Tag getRoot ( ) 
{ 

return root; 

} 

/** 

* Adds a child Tag to the root Tag of this document. 

* Oparam child A Tag object to add as a child of the root Tag. 
public void addChild (Tag child) throws InvalidTagException 

getRoot {) .addChild (child) ; 

} 

/** 

* Returns the entire rendered document text, suitable for display 

* in a browser which supports the MIME type specified by the document's 

* content -type. 

* @param formatted markup language as String 
*/ 

public String render () 

return root . render ( ) ; 

} 

/** 

* The Internet MIME content-type which this document supports. 

* ©return an official internet mime-type such as text/html, or text/vnd.wap.wml 
public String getContentType { ) 

return contentType ,- 
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package com. thinairapps -tag .html ; 
import com . thinairapps . tag . * ; 
/** 

* Used to define intra or inter page hyperlinking action, 
public class Anchor extends HTMLTag 
/** 

* (Sparam name anchor name (used for intra page linking) 
*/ 

public Anchor (String name) 
super ( "a" , true) ; 

if (name 1= null && name . length ( ) > 0) 
addAttribute ( "name" , name) ; 



* (Sparam name anchor name (used for intra page linking) 

* (Sparam child a child node to wrap within this tag 

public Anchor (String name, HTMLTag child) 



* @param name anchor name (used for intra page linking) 

* ©parara href the URL or fttagname which this anchor should link to 
*/ 

public Anchor (String name. String href) 
this (name) ; 

addAttribute ("href ", href) ,- 

} 

/** 

* @param name anchor name (used for intra page linking) 

* ©param href the URL or #tagname which this anchor should link to 

* ©param child a child node to wrap within this tag 

public Anchor (String name, String href, HTMLTag child) 

this (name, child) ; 
addAttribute ("href", href) ; 



* @param name anchor name (used for intra page linking) 

* @param href the URL or #tagname which this anchor should link to 

* ©param target the name of target window or frame which to target the hyperlink actii 

* (Sparam child a child node to wrap within this tag 

public Anchor (String name, String href, String target , HTMLTag child) 

this (name, child) ; 
addAttribute ("href ", href ) ; 
addAttribute ( "target" , target) ; 



/** 

* @param action set a client-side scripting event 
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*/ 

public void setOnMouseOver (String action) 
addAttribute ( "onMouseOver" , action) ; 

} 

/** 

* ©param action set a client -side scripting event 

public void setOnMouseOut (String action) ( 
addAttribute ( "onMouseOut" , action) ; 

} 

/** 

* ©param action set a client-side scripting event 

public void setOnClick (String action) { 
addAttribute ( "onClick" , action) ,- 
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package com. thinairapps . tag .html ; 
import com. thinairapps .tag. * ; 



■ The main content tag for an html page 

■ @(#)Body. java 



public class Body extends HTMLTag 



Tag headers- 
Tag footer; 



public BodyO 
{ 

super ( "body" 



* @param bgColor hex or nai 

* ©param fgColor hex or nat 

* @param linkColor hex or i 



: value for page background color 
: value for text font color 
me value for link font color 



public Body (String bgColor, String textColor, String linkColor) 
this ( ) ; 

addAttribute ("bgColor" , bgColor) ; 
addAttribute ( "text" , textColor) ,- 
addAttribute ( "link" , linkColor) ; 
addAttribute ( "alink" , linkColor) ; 
addAttribute ( "vlink" , linkColor) ; 



/** 

* ©param background url to a background image file 

* ®param bgColor hex or name value for page background color 

* iSparam fgColor hex or name value for text font color 

* ©param linkColor hex or name value for link font color 
*/ 

public Body (String background, String bgColor, String fgColor , String linkColor) { 
this (bgcolor, fgColor, linkColor) ; 
addAttribute ( "background" , background) ; 



* ©param p paragraph element to add as child 
*/ 

public void addParagraph ( Paragraph p) { 
try { addChild(p) ; ) 
catch (InvalidTagException e) {} 



/** 

* @param action scripting action to perform when page is loaded 

public void setOnLoad (String action) { 
addAttribute ( "onLoad" , action) ; 

} 

/** 

* ©param header HTMLTag to display at the top of each page 
*/ 

public void setHeader (HTMLTag header) 
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this. header = header; 

} 

/** 

* ©param footer HTMLTag to display at the bottom of each page 
*/ 

public void setFooter (HTMLTag footer) 
{ 

this. footer = footer; 

} 

public String render {) 
{ 

StringBuffer output = new StringBuf f er ( ) ; 

output . append ( renderOpenTag ( ) ) ; 

if (header != null) 
output .append (header . render ( ) ) ; 

output. append (renderChildrenO ) ; 

if (footer != null) 
output -append (footer . render ( ) ) ; 

output . append ( renderCloseTag ( ) ) ; 

return output . toString ( ) ; 



3 
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package com . thinairapps . tag . html ; 
import com. thinairapps. tag. Tag, - 
/** 

* A text formatting node that indicates the text that should be displayed in bold. 

public class Bold extends HTMLTag 
{ 

/** 

* Basic Constructor 
*/ 

public Bold 0 
super ( "b" ) ; 



* @param text content that should be displayed in BOLD 
*/ 

public Bold (String text) 
this ( ) ; 

addChild(new Text (text) ) ; 



* @param tag HTMLTag that should be added as default child to this tag 
public Bold (HTMLTag tag) 
this ( ) ; 

addChild(tag) ; 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag. * ; 
/** 

* <br>- inserts a line break into the content 
*/ 

public class Break extends HTMLTag 

public Break ( ) { 

super ( "br" , false) ; 

} 

public String render () { 
return "<BR>"; 
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package com. thinairapps . tag -html ; 
/** 

* A form element that can be used to trigger actions 
public class Button extends Input 
/** 

* ©param name the unique identifier for this button 
*/ 

public Button (String name) { 
super ( "button" , name) ; 

} 

/** 

* @param name the unique identifier for this button 

* @param value the displayed text on the button 
*/ 

public Button{String name, String value) 
super ( "button" , name, value) ; 

} 

* Oparam action scriptable action caused when button is clicked 
~ */ 

public void setOnClick {String action) 
addAttribute ("onclick" , action) ; 

} 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 

* All children tags of this tag will be centered on the page 

public class Center extends HTMLTag 

public Center () 
{ 

super ( "center true) ; 

} 

/** 

* Construct with a default child tag 

* Oparam child the default child tag to be centered 
*/ 

public Center (HTMLTag child) 
{ 

super ( "center" , true) ; 
addChild (child) ; 
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package com. thinairapps . tag . html ; 
import com. thinairapps . tag .* ,- 
/** 

* A form element indicating a boolean state 
*/ 

public class CheckBox extends Input 

public final static int IjABEL_BEFORE = 0 ; 
public final static int IjABEL_AFTER = 1; 



/** 

* ©param name the unique 

* ©param value the default value to submit (if checked is true) 

* ©param checked indicates state of checkbox 
*/ 

public CheckBox (String name, String value, boolean checked) 

super ( "checkbox" , name, value) ; 

if (checked) 

addAttribute (new Attribute ( "checked" ) ) ; 

} 

/** 

* @param name the unique 

* ©param value the default value to submit (if checked is true) 

* ©param checked indicates state of checkbox 

* ©param label a tag class to use as a label for this element 

* ©param orientation a constant indicating position of label (LABEL_BEFORE | | LABEL_AFTER) 

public CheckBox (String name, String value, boolean checked , HTMLTag label, int orientation) { 
this (name , value , checked) ; 
setLabel (label , orientation) ; 

} 



/** 

* ©param label a tag class to use as a label for this element 
* ©param orientation a constant Indicating position of label (LABEL BEFORE | I LABEL AFTER) 
*/ , - M _ 

public void setLabel (Tag label, int orientation) 

this. label = label; 

this. orientation = orientation; 

} 

public String render ( ) { 

StringBuffer output = new StringBuf f er ( ) ; 

if (label != null && orientation == LABEL_BEFORE) 
output . append ( label . render ( ) ) ; 

output . append { super . render ( ) ) ; 

if (label 1= null && orientation == LABEL_AFTER) 
output . append ( label . render ( ) ) ,- 

return output . toString ( ) ; 

} 



} 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 

* Insert a hidden text comment into the page 
*/ 

public class Comment extends HTMLTag 
{ 

/** 

* ©param text message to put in comment 
*/ 

public Comment (String text) { 

superC'!-- " + text + " false) ; 

} 

} 
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package com . thinairapps . tag . html ; 
/** 

* A link to a cascading stylesheet document- should be put in page header 

public class CSSLink extends Link 
{ 

/** 

* @paratn href url link to CSS document 
*/ 

public CSSLink (String href) 
{ 

super ("stylesheet", "text/ess", href); 

} 
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package com . thinairapps . tag . html ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* A basic widget for creating a body tag that displays some text. You must 

* call the Construcor and buildPageO for the tag hierarchy to be created. 
*/ 

public class DisplayBody extends Body 
{ 

public DisplayBody ( ) 
{ 

super { ) ; 



* @param text message to be displayed 

* @param align alignment (Paragraph . CENTER, etc.) to use < 
*/ 

public void buildPage (String text. String align) 

Paragraph p = new Paragraph (align) ; 
p.addChild{new Text (text )> ; 
addParagraph (p) ; 



* @param text message to be displayed 

* @param align alignment (Paragraph. CENTER, etc.) to use on t 

* (Sparam href url link to insert into page via confirmation b 
*/ 

public void buildPage (String text, String align, String href) 
try { 

Paragraph p = new Paragraph (align) ; 
p.addChild(new Text (text) ) ; 
addParagraph (p) ; 
addChlld{new Break () ) ; 

addChild (new Anchor ( " " , href , new Text { "Ok" ) ) ) ; 

} 

catch (InvalidTagException e) { 
e .printStackTrace ( ) ; 

} 
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package com . thinairapps . tag . html ; 
import com . thinairapps . tag . * ; 
/** 

* A tag indicated text styling parameters 
*/ 

public class Font extends HTMLTag 
{ 

/** 

* @param face the font face to apply to all children text tags 
*/ 

public Font (String face) 
( 

super ( "font" , true) ; 
addAttribute ( "face" , face) ; 



* @param face the font face to apply to all children text tags (i.e. Arial, Helvi 

* (gparam size the font size to apply to all children text tags 
*/ 

public Font (String face,int size) 
{ 

this (face) ; 

addAttribute { "size" ," " + size) ; 

} 

/** 

* ©param face the font face to apply to all children text tags (i.e. Arial, Helv< 

* ©param size the font size to apply to all children text tags 

* (Sparam color a hex or named color value to apply to all children text tags 

public Font (String face,int size, String color) 
this (face, size) ; 

addAttribute ("color" , "#" + color); 
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package com. thinairapps .tag .html ; 
import com. thinairapps . tag. * ; 

* A Form element for gathering user input and submitting it to an HTTP server 
*/ 

public class Form extends HTMLTag 
{ 

/** 

* ©param name the unique form id 
V 

public Form (String name) 
{ 

super ( " form" , true ) ; 

addAt tribute ( "name" , name) ; 

} 

* @param name the unique form id 

* Oparam action the URL which to post the form data to 

* @param method the HTTP method which to submit the data with (POST, GET, PUT) 
*/ 

public Form(String name, String action, String method) { 
this (name) ; 

addAttribute ( "action" , action) ; 
addAttribute ( "method" , method) ; 

} 

/** 

* (Sparam elem add a ForraElement subclass as a child to this form 
*/ 

public void addFormElement (FormElement elem) { 
try { 

addChild(elem) ; 
// if ( ! (elem instanceof Hiddenlnput) ) 
// addChild(new Break ()); 

} 

catch (InvalidTagExcept ion e) {} 



} 
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package com . thinairapps . tag . html ; 
import com . thinairapps . tag . * ; 
/** 

* An element used as a base class for all form input elements 
*/ 

public class FormElement extends HTMLTag 
{ 

/** 

* @param tagName the name of the form element tag (" input ", "button" ) 

* ©param name the unique id of this element 

* ©param closedTag indicates if this tag is standalone or has a closing pair 

public FormElement (String tagName, String name, boolean closedTag) 

super (tagName, closedTag) ; 
addAttribute { "name" ,name) ; 
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package com . thinairapps . tag . html ; 
import com. thinairapps -tag. * ; 
/** 

* Tag to create header section within an HTML page 
*/ 

public class Head extends HTMLTag 
{ 

public HeadO { 

super ( "head" , true) ; 
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package com . thinairapps . tag. html ; 
/** 

* A Form element used for setting hidden variable values within a form 
*/ 

public class Hiddenlnput extends Input 
/** 

* ©param name the unique id for this element 

* @param value the value to send for this variable 
*/ 

public Hiddenlnput (String name, String value) 
super ( "hidden" , name, value) ; 

} 

} 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 
/** 

* Creates a horizontal line for seperating content on a page 
*/ 

public class HorizontalRule extends HTMLTag 
{ 

public HorizontalRule ( ) { 
super { "hr" , false) ; 

} 

/** 

* ©param width a pixel value for the width of this rule 

* ©param noShane indicates whether to have any shade or shadow on this rule 
*/ 

public HorizontalRule ( int width, boolean noShade) 
{ 

thisO ; 

addAttribute (new Attribute ( "width" , " " + width, false) ) ; 

if (noShade) 

addAttribute (new Attribute ( "noShade" ) ) ; 

} 

/** 

* ©param width a percentage value for the width of this rule 

* @param noShane indicates whether to have any shade or shadow on this rule 
*/ 

public HorizontalRule {String width, boolean noShade) { 
thisO ; 

addAttribute (new Attribute ( "width" , width, true) ) ,- 

if (noShade) 

addAttribute (new Attribute ( "noShade" )) ; 

} 

} 
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package com . thinairapps . tag . html ; 
import com. thinairapps. tag.*; 
import java -util -Enumeration ; 
/** 

* The super class for all HTML tag implementions 
*/ 

public class HTMLTag extends Tag 
{ 

/** 

* A constructor which creates a tag with the given name, and which may either be wr 

standalone or a pair. 

* ©param name the text to use for this tag (i.e. 'body' would be the value for fclt ;body&:i^ 

gt;) 

* ©param closingTag indicates whether this tag has a paired closing tag or is standalone 
*/ 

public HTMLTag (String name, boolean closingTag) { 
super (name, closingTag) ; 

* A constructor which creates a tag set with the given name. 

* @param name the text to use for this tag (i.e. 'body' would be the value for &lt rbodv&i^- 

gt;) 

*/ 

public HTMLTag (String name) { 
super (name) ; 

} 

protected String renderOpenTag () { 

StringBuffer output = new StringBuf f er { ) ; 

//render self open 
output . append ( " < " ) ; 
output . append (getName ( ) ) ; 

Enumeration eAttribs = getAttributes (). elements () ; 

while (eAttribs. hasMoreElements ( ) ) 

output . append ( " " + ( (Attribute) eAttribs . nextElement ()). render ()) ; 

output . append ( " > " ) ; 

return output . toString ( ) ; 



} 
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package com . thinairapps . tag . html ; 
import com . thinairapps . tag . * ; 
/** 

* The basic "page" object, used for all html document rendering 
*/ 

public class HTMLTagDocument extends TagDocument 
{ 

private Head head; 
private Body body; 

public HTMLTagDocument ( ) { 

super { "html "text/html " ) ; 

} 

/** 

* Oparam head set the header section for this page 
*/ 

public void setHead(Head head) { 
this. head = head; 
resetChildrenO ; 

} 

/** 

* Oparam body set the main content body section for this page 
*/ 

public void setBody(Body body) { 
this. body = body; 
resetChildrenO ; 

} 

private void resetChildrenO { 
getRootO .clearChildrenO ; 

try { 

if {head != null) 

getRootO .addChild(head) ; 

if {body != null) 

getRootO .addChild{body) ; 

} 

catch (InvalidTagException e) {} 
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package com . thinairapps . tag . html ; 

import com. thinairapps .tag . InvalidTagException; 

/** 

* Creates an anchor object with an img tag child 
*/ 

public class Hyperlinkedlmage extends Anchor 
{ 

/** 

* ®param href the url which to link to 

* @param imgSrc the image url which to load 
*/ 

public Hyperlinkedlmage (String href, String imgSrc) 
super { " " , href , new Image ( imgSrc> ) ; 

} 

/** 

* ©param name a unique id to use for the anchor and image 

* (Sparam href the url which to link to 

* ©param imgSrc the image url which to load 
*/ 

public Hyperlinkedlmage (String name, String href, String imgSrc) 
{ 

this (name, href) ; 

Image imgl = new Image (imgSrc) ; 
imgl .addAttribute ( "name" ,name) ; 
addChild (imgl) ; 

} 

/** 

* @param name a unique id to use for the anchor and image 

* ©param href the url which to link to 

* @param imgSrc the image url which to load 

* @param target the target window or frame which to send the hyperlink action to 
*/ 

public Hyperlinkedlmage (String name, String href, String imgSrc, String target) 
this (name, href , imgSrc) ; 
addAttribute ( "target" , target) ; 

} 

} 
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* @ (#) Image . java 

* an element used to insert an image into a page 
*/ 

package com. thinairapps . tag .html ; 

import com. thinairapps . tag .* ; 

import java. util .Enumeration; 

/**Represents an <img> tag in HTML 
*/ 

public class Image extends HTMLTag 
{ 

* Creates the image tag 

* @param src the url to load the image file from 
*/ 

public Image (String src) { 
super ( "img" , false) ; 

addAttribute (new Attribute ( "src" , src) ) ; 
addAttribute (new Attribute ( "border "," 0 ", false) ) ; 

} 

/** 

* @param src the url to load the image file from 

* ©param alt the text to display if device does not support image 
*/ 

public Image (String src, String alt) { 
this (src) ; 

addAttribute (new Attribute ( "alt" , alt) ) ; 

} 



/** 

* ®param src the url to load the image file from 

* ©param alt the text to display if device does not support image 

* @param width the pixel width of image 

* ©param height the pixel height of image 
*/ 

public Image (String src, String alt,int width, int height) { 
this (src, alt) ; 

addAttribute (new Attribute ( "width" , " " + width, false) ) ; 
addAttribute (new Attribute ( "height" " + height, false) ) ; 



/** 

* ©param return String returns only the ALT text for this element 
*/ 

public String getTextOnly ( ) { 

string imgText = getName ( ) ; 

Enumeration eAttributes = getAttributes (). elements () ; 
Attribute cAttrib; 

while (eAttributes .hasMoreElements ( ) ) { 

cAttrib = (Attribute) eAttributes .nextElement 0 ; 

if (cAttrib. getName () .equalsIgnoreCase ( "alt ") ) { 
imgText = cAttrib .getValue () ; 

} 
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return "[" + imgText + "]"; 
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package com. thinairapps . tag .html ,- 

/** 

* A basic form alt ; input&gt ; element 
*/ 

public class Input extends FormElement 
( 

/** 

* @param type the input type (button, submit, password, etc) 

* ©pararn name the unique id for this input 
*/ 

public Input (String type, String name) 
{ 

super ( "input" .name, false) ; 
addAttribute ( "type" , type) ; 

} 

/** 

* @param type the input type (button, submit, password, etc) 

* ©param name the unique id for this input 

* ©param value the default value 
*/ 

public Input (String type, String name, String value) { 
this (type, name) ; 

addAttribute ( "value" , value) ; 

} 

=5 /** 

~ * ©param value set the default value for this input 
*/ 

public void setValue (String value) { 
addAttribute ( "value" , value) ,- 

} 
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package com. thinairapps .tag. html ; 

* A form text-type &lt ; input&gt ; element with a text label 
*/ 

public class Labeledlnput extends Input 
{ 

String label ; 
/** 

* @param name the unique id of this input 

* Oparam label the text label to display 
*/ 

public Labeledlnput (String name, String label) { 
super ( "text" , name) ; 
this. label = label; 

} 

/** 

* @parara name the unique id for this input 

* ©param type the input type (button, submit, password, etc) 

* ©parara value the default value 

* @param label the text label to display 
*/ 

public Labeledlnput (String name, String type, String value, String label) { 
super (type, name, value) ; 
this. label = label; 

} 

* Oparam the text label to use for this input 
*/ 

public void setLabel (String label) { 
'"^ this, label = label; 

} 

public String getLabelO { 
return label; 

} 

public String render () { 

return label + new NonBreakingSpace ( 1) . render ( ) + super . render () ; 
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package com. thinairapps . tag .html ; 

/** 

* A tag to use for linking in style- sze-ets and other content 
*/ 

public class Link extends HTMLTag 



@param rel indicate the relat ic- siiip from this document to the target 

■ ©param type specify the MIME c^v-re for the linked document 

■ ©param href specify the hyperrexr reference URL of the target document 



public Link (String rel. String 
{ 

super ("link", false); 
addAttribute ( " rel " , rel ) ; 
addAttribute (" type" , type ) ; 
addAttribute ( "href ", href ) ; 
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package com. thinairapps . tag . html ; 
/** 

* A tag to be used in header sections to indicate some metadata about the content 
*/ 

public class Meta extends HTMLTag 
{ 

public final static String PROPERTY_NAME = "name"; 

public final static String PROPERTY_HTTP_EQUIV = "http- equiv" ; 

public final static String PROPERTY_USER_AGENT = "user-agent"; 

/** 

* (Sparam propertyType the name in the content name/value pair 

* Oparam propertyValue the value in the content name/value pair 

* Oparam content the value for the "content" attribute 
*/ 

public Meta(String propertyType, String propertyValue , String content) 
super { "meta" , false) ; 

addAttribute (propertyType, propertyValue) ; 
addAttribute ( "content" , content) ; 

} 

} 
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package com. thinairapps . tag . html ; 
/** 

* Inserts a blank space into a page 
*/ 

public class NonBreakingSpace extends Text 
{ 

/** 

* (Sparam number the number of spaces to insert 
*/ 

public NonBreakingSpace (int number) { 
super ( " " ) ; 

for (int i = 0; i < number; i++) 

setName (getName ( ) + " &nbsp ,- " ) ,- 

) 
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package com . thinairapps . tag . html ; 

import com. thinairapps . tag . I nvalidTag Except ion; 
import com. thinairapps . tag .Attribute, ■ 

/** 

* An &lt ;option&gt ; element to be added to a &lt ;Select&gt ; parent tag 
*/ 

public class Option extends HTMLTag 
{ 

public Option () { 

super ( "option") ; 

} 

* @param value return the specified value to the form-processing application instead of nf 

the option contents 

* (Sparam label provide a label for this option 
*/ 

public Option (String value, String label) { 
thisO ; 

addAttribute ( "value" , value) ,- 
setLabel (label) ,- 

} 

=0 * @param label set the label 
*/ 

public void setLabel {String label) { 

try { addChildlnew Text (label) ) ; } 
catch { InvalidTagException e) { } 

} 

/** 

* @param child HTMLTag 
*/ 

public void addChi Id (HTMLTag child) throws InvalidTagException { 
if (child instanceof Text) 
super. addChild (child) ; 

throw new InvalidTagException( "Option only supports Text or OnEvent children 
tags " ) ; 

^ } 

* @param selected boolean value for making this item intially selected 
*/ 

public void setSelected (boolean selected) { 
if (selected) 

addAttribute (new Attribute ("selected" ) ) ; 

} 
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package com. thinairapps . tag . html ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* An element used to separate content section out within a page 
*/ 

public class Paragraph extends HTMLTag 
{ 

public final static String ALIGN_LEFT = "left"; 
public final static String ALIGN_CENTER = "center" ; 
public final static String ALIGN_RIGHT = "right" ; 

public final static String ALIGN_JUSTIFY = "justify"; 

public Paragraph 0 { 
super ( "p" ) ; 

} 

public Paragraph (String align) { 
thisO ; 

addAttribute ( "align" , align) ; 

} 

public void addChild (HTMLTag tag) { 
try { super. addChild (tag) ; } 
catch (InvalidTagException e) { 
e -printStackTrace { ) ; 

} 
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package com . thinairapps . tag . html ; 
/** 

* A text form input with an * mask for security 
*/ 

public class PasswordField extends Input 
{ 

/** 

* ©param name specify the name of the parameter to be passed to the form-processing 

applicaiton for this input element 

* ©param value specify the initial value for this element 

* @parara length specify the maximum number of characters to accept for this element 
*/ 

public PasswordField (String name. String value, int length) { 
super ( "password" , name, value) ; 
addAttribute ( "size" , " " + length); 

} 

/** 

* (Sparam name specify the name of the parameter to be passed to the form-processing 

applicaiton for this input element 

* (Sparam length specify the maximum number of characters to accept for this element 
*/ 

public PasswordField (String name, int length) { 
super ( "password" , name) ; 
O addAttribute ( "size" ," " + length); 

m } 
I'l /** 

* @param name specify the name of the parameter to be passed to the form-processing 

applicaiton for this input element 

*/ 

public PasswordField (String name) { 
supe r (" pa s sword " , name ) ; 

m ) 
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package com. thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 
/** 

* Separates out text that has been preformatted 
*/ 

public class Pre extends HTMLTag 
{ 

public PreO { 

super ( "pre" , true) ; 

} 

} 
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package com . thinairapps . tag . html ; 
/** 

* A form element used to reset the form content to its default state 
*/ 

public class ResetButton extends Input 
{ 

/** 

* Oparam value specify an alternate label for the reset button 
*/ 

public ResetButton (String value) 
{ 

super ( "reset" , " ", value) ; 

} 

/** 

* Oparam action action taken onClick 
*/ 

public void setOnClick (String action) { 
addAttribute ( "onClick" , action) ; 
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package com. thinairapps . tag. html ; 
import com . thinairapps . tag . * ; 
/** 

* Used to set of scripting code from the page content 
*/ 

public class Script extends HTMLTag 
{ 

/** 

* @param language the scripting language the code is written in 
*/ 

public Script {String language) { 
super { "script" , true) ; 

addAttribute (new Attribute (" language ", language ) ) ; 

} 

/** 

* ©param code the scripting code to insert into the page 
*/ 

public void setCode (String code) { 
addChildCnew Text (code) ) ; 

} 
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package com . thinairapps . tag . html ; 
import com. thinairapps. tag.* ; 
/** 

* A form input used to create a list or combo-box 
*/ 

public class Select extends FormElement 
{ 

/** 

* ©param name unique id of this element 
*/ 

public Select (String name) { 

super ( "select" , name, true) ; 

} 

/** 

* Oparam text the displayed text for this entry 

* @param selected indicates if this entry should be selected 
*/ 

public void addOpt ion (String text, boolean selected) 
{ 

Tag option = new Tag ( "option" ) ; 
if (selected) 

option. addAttribute (new Attribute ( "selected" ) ) ; 

option. addChild (new Text (text) ) ; 
addChild (option) ; 

} 

/** 

* ©param option an Option HTMLTag to add to this select list 
*/ 

public void addOpt ion (Option option) { 
try { addChild (option) ; } 
catch (InvalidTagException e) {} 



/** 

* ©param value the submitted value for a new option entry 

* @param label the display value for a new option entry 
*/ 

public void addOption (String value, String label) { 
Option option = new Option (value, label ) ; 
addOption (option) ; 

} 

/** 

* @param options a set of option entries to add to this select list 
*/ 

public void setOptions (String [] options) { 
for(int i = 0; i < options . length; i++) 

addOption (new Option (options [i] , options [ i] ) ) ; 

} 
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package com. thinairapps . tag .html ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* A widget used to create a Body with a form with a select tag and a submit button 
*/ 

public class Select InputBody extends Body 
{ 

public Select InputBody ( ) { 
super ( ) ; 

} 

* Oparam bgColor set the background color of the document 

* @param fgColor set the color of regular text in the document 

* ©param linkColor set the color of hypertext links in the document 
*/ 

public SelectlnputBody (String bgColor, String fgColor, String linkColor) { 
super () ; 

addAttribute ( "bgColor bgColor ) ; 
addAttribute ( "text" , fgColor) ; 
addAttribute ( "link" , linkColor) ; 
addAttribute ( "alink" , linkColor) ; 
addAttribute ( "vlink" , linkColor) ; 

} 

ill /** 

* ©param background specify the URL of an image to be tiled in the document background 

* ©param bgColor set the background color of the document 

* ©param fgColor set the color of regular text in the document 

* ©param linkColor set the color of hypertext links in the document 
*/ 

public SelectlnputBody (String background, String bgColor, String fgColor , String 
linkColor) { 

super (bgColor, fgColor, linkColor) ; 
addAttribute ("background" , background) ; 

} 

/** 

* ©param href the url to submit the form to 

* ©param label the label to use for the select element 

* ©param name the unique id of the select element 

* ©param optionValues the array of name/value pairs to use for the option elements 

* ©param align the Paragraph alignment value to use for the content 
*/ 

public void buildPage (String href^String label, String name , String [] [] opt ionVals, String 
align) throws InvalidTagException { 

Option[] options = new Option [optionVals . length] ; 

for (int i = 0; i < optionVals . length; i++) 

options[i] = new Option (optionVals [i] [1] , optionVals li] [0] ) ; 

buildPage (href , label , name, options, align) ; 

} 

/** 

* ©param href the url to submit the form to 

* ©param label the label to use for the select element 

* ©param name the unique id of the select element 

* ©param options the array of Option tags to add to the select list 

* ©param align the Paragraph alignment value to use for the content 
*/ 

public void buildPage (String href, String label, String name, Option [] options , String 
align) throws InvalidTagException { 



Paragraph p = new Paragraph (align) ; 
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p.addChild{new Text (label) ) ; 
p.addChild(new Break () ) ; 

Form form = new Form {" fonnl" , href , "GET" ) ; 

Select select = new Select (name) ; 
Option cOpt = null; 

for (int i = 0; i < options . length; i++) 
select. addOption (options [i] ) ; 



form. addChild ( select ) ; 

form. addChild (new SubmitButton ( "Submit " ) ) ; 
p. addChild (form) ; 
addChild Cp) ; 

} 
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package com. thinairapps . tag -html ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* A widget used to create a Body with a form with a text input and a submit button 
*/ 

public class SinglelnputBody extends Body 
{ 

public SinglelnputBody () 
{ 

super ( ) ; 

} 

/** 

* ©param href url to submit form to 

* ©param label text label for input tag 

* ©param name unique id for this form input 

* ©param buttonLabel label for submit button 
*/ 

public void buildPage (String href. String label. String name. String buttonLabel) 



Paragraph p = new Paragraph {) ; 

Form form = new Form ( "forml" , href, "GET") ; 

Labeledlnput input = new Labeledlnput (name, "text" ,"", label) , - 
form.addFormElement (input) ; 

form.addFontiElement (new SubraitButton (buttonLabel) ) ; 
p.addChild(form) ; 
addParagraph (p) ; 
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package com. thinairapps . tag . html ; 

import com. thinairapps . tag . InvalidTagException; 

/** 

* A widget used to create a Body tag with a form with a text input and a submit button 
*/ 

public class SinglelnputPage extends Body 
{ 

public SinglelnputPage 0 { 
super ( ) ; 

} 



/** 

* @param href url to submit form to 

* @param label text label for input tag 

* ©param name unique id for this form input 

* ©param buttonLabel label for submit button 
*/ 

public void buildPage (String href, String label, String name, String buttonLabel) { 

Paragraph p = new Paragraph ( ) ; 

Form form = new Form { "forml" ,href, "GET" ) ; 
Labeledlnput input = new Labeledlnput (name , "text label ) ; 
f orm.addForraElement (input) ,- 

form. addPorraElement (new SubmitButton (buttonLabel) ) ; 
p.addChild(form) ,- 
r; addParagraph(p) ; 

} 

} 
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package com . thinairapps . tag . html ; 

/** 

* A form element used to trigger the submit action 
*/ 

public class SubmitButton extends Input 
/** 

* ©param value the display text on the button 
*/ 

public SubmitButton (String value) { 
super { "submit " , " submit " , value) ; 

} 

public SubmitButton (String value, String name) { 
super { "submit" , name, value); 

} 

/** 

* ©param action the scripting action to trigger when the butto 
*/ 

public void setOnClick (String action) { 
addAttribute ( "onClick" , action) ; 
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package com. thinairapps . tag . html ,- 
import com . thinairapps . tag . * ; 
/** 

* A <table@gt; HTML element to display tabular structured content 
*/ 

public class Table extends HTMLTag 
{ 

/** 

* @param border an int value indicated the thickness of the table border 
*/ 

public Table (int border) 
{ 

super ( "table" , true) ,- 

addAttribute (new Attribute ( "border "," " + border, false) ) ; 

} 

/** 

* ©param border an int value indicated the thickness of the table border 

* ©param cellpadding an int value indicated space padding within each table cell 

* ©param cellspacing an int value indicated spacing between each table cell 
*/ 

public Table (int border, int cellpadding, int cellspacing) { 
this (border) ; 

O addAttribute (new Attribute ( "cellpadding" " + cellpadding, false) ) ; 

addAttribute (new Attribute ( "cellspacing" ," " + cellspacing, false) ) ; 



/** 

* ©param border an int value indicated the thickness of the table border 

* ©param cellpadding an int value indicated space padding within each table cell 

* ©param cellspacing an int value indicated spacing between each table cell 

* ©param width sets the width of the table in pixels 

* ©param height sets the height of the table in pixels 
*/ 

public Table (int border, int cellpadding, int cellspacing, int width, int height) { 
this (border, cellpadding, cellspacing) ; 

addAttribute (new Attribute ( "width" , " " + width, false) ) ; 
addAttribute (new Attribute ( "height" , " " + height , false) ) ,- 

/** 

* ©param border an int value indicated the thickness of the table border 

* ©param cellpadding an int value indicated space padding within each table cell 

* Oparam cellspacing an int value indicated spacing between each table cell 

* ©param width sets the width of the table in percentage 

* ©param height sets the height of the table in percentage 
*/ 

public Table (int border, int cellpadding, int cellspacing, String width, String height) { 
this (border, cellpadding, cellspacing) ; 
addAttribute (new Attribute { "width" , width) ) ; 
addAttribute (new Attribute ( "height" , height) ) ; 
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package com . thinairapps . tag . html ; 
/** 

* &;lt ; td&gt ; - an individual cell for a table 
*/ 

public class TableCell extends TableElement 
{ 

public TableCell 0 { 
super ( "td" ) ; 

} 

/** 

* @param width pixel width of cell 

* ®param height pixel height of cell 

*/ 

public TableCell (int width, int height) { 
super { "td" , width, height) ; 

} 

/** 

* ©param width pixel width of cell 

* @param height pixel height of cell 

* Oparam bgColor hex or named color for background of cell 
*/ 

public TableCell (int width, int height , String bgColor) { 
super ( "td" , width, height , bgColor) ; 

} 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 
/** 

* A super class for all table cells, headers rows, etc 
*/ 

public class TableElement extends HTMLTag 
{ 

* @param tag name of Table 
*/ 

public TableElement (String tag) { 
super (tag, true) ; 

} 

/** 

* ©param tag name of Table 

* ©param width width of Table 

* ©param height height of Table 
*/ 

public TableElement (String tag,int width, int height) { 
this (tag) ; 

addAttribute (new Attribute ( "width" ," " + width, false) ) ; 
addAttribute (new Attribute ("height", + height , false) ) ; 



* ©param tag name of Table 

* ©param width width of Table 

* ©param height height of Table 

* ©param bgColor define the background color for the entire Table 
*/ 

public TableElement (String tag, int width, int height , String bgColor) { 
this (tag, width, height) ; 
addAttribute ( "bgColor" , bgColor) ; 
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package com. thinairapps . tag .html ; 
/** 

* A table cell to use in the header row 
*/ 

public class TableHeader extends TableElement 
{ 

public TableHeader { ) { 
super ( "th" ) ; 

} 

/** 

* @param width set the width of the cell to X pixels or a percentage of the table width 

* Oparam height define the height, in pixels, for this cell 
*/ 

public TableHeader (int width, int height) { 
super ( "th" , width, height ) ; 

} 



/** 

* ©param width set the width of the cell to X pixels or a percentage of the table width 

* @param height define the height, in pixels, for this cell 

* ©pararn bgColor define the background color for the cell 
*/ 

public TableHeader ( int width, int height. String bgColor) { 
super ( " th" , width , height , bgColor) ; 

} 
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package com . thinairapps . tag . html ; 
/** 

* &lt ;tr&gt ; - the element to use for each row of the table 
*/ 

public class TableRow extends TableElement 
{ 

public TableRow () { 
super ( "tr" ) ; 

} 

public TableRow (int width, int height) { 
super { "tr" , width, height) ; 

} 

public TableRow (int width, int height. String bgColor) { 
super { " tr " , width , height , bgColor) ; 

} 

} 
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package com.thinairapps.tag.html ; 
import com . thinairapps . tag . * ; 
/** 

* A node used to wrap any text content for a page 
*/ 

public class Text extends HTMLTag 
{ 

public Text (String text) { 
super (text , false) ; 

} 

public String getTextOnly ( ) { 
return getName ( ) ; 

} 

public String render { ) { 
return getName ( ) ; 

} 
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package com. thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 

* A multiline, scrollable text area input form element 
*/ 

public class TextArea extends FormElement 
{ 

/** 

* @param name the unique id of this element 

* @param rows the number of rows 

* @param cols the number of columns 
*/ 

public TextArea {String name,int rows , int cols) { 
super ( "textarea" , name, true) ; 

addAttribute ( "rows" , " " + rows) ; 
addAttribute ("cols" , " " + cols); 

} 

/** 

* ®param text set the text value for this element 
*/ 

public void setValue (String text) { 

getChildrenO . removeAllElements ( ) ,- 
getChildrenO .addElement (new Text (text) ) ; 
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package com. thinairapps . tag . html ,- 
/** 

* A single text input form element 
*/ 

public class TextField extends Input 
{ 

/** 

* @param name specify the name of the parameter that is passed to the form-processing ^ 

application for this input element 

* @param value specify the intial value for this element 

* ©param length specify the maximum number of characters to accept for this element 
*/ 



public TextField (String name. String value, int length) { 
super ( "text" , name, value) ; 
addAttribute ("size", "" + length); 

} 

/** 

* ©param name specify the name of the parameter that is passed to the form-processing kT 

application for this input element 

* ©param length specify the maximum number of characters to accept for this element 

public TextField (String name, int length) { 
super ( " text " , name ) ; 
addAttribute (" size" ," " + length) ; 

/** 

* ©param name specify the name of the parameter that is passed to the form-processing 

application for this input element 

*/ 

piiblic TextField (String name) { 
super ( " text " , name ) ; 

} 

} 
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package com. thinairapps . tag . html ; 
import com . thinairapps . tag . * ; 
/** 

* A utility wrapper class for applying styles to text content 
*/ 

public class TextStyle extends HTMLTag 
{ 







static 


int 


PLAIN = 0; 


public 


final 


static 


int 


BOLD = 1; 


public 


final 


static 


int 


ITALIC = 2 


public 


final 




int 


UNDERLINE 


public 


final 


static 


int 


TT = 4; 



public final static int HI : 
public final static int H2 ■ 
public final static int H3 ^ 
public final static int H4 : 
public final static int H5 ■■ 
public final static int H6 : 



style 



PLAIN; 



public TextStyle { int style) { 
super ( " " , true ) ; 
this. style = style; 



* ©param style the style CONSTANT to apply 

* @param child the htmltag to wrap the style around 
*/ 

public TextStyle (int style, HTMLTag child) { 
super { " " , true) ; 
this. style = style; 
addChild (child) ; 



protected String renderOpenTag ( ) 
if (style == BOLD) 





return "<b>"; 




els 


e if (style == 


ITALIC) 










e if (style == 


UNDERLI 


els 


e if (style == 


TT) 




return "<tt>" 




els 


e if (style == 


HI) 




return "<hl>" 




els 


e if (style == 


H2) 




return "<h2>" 




els 


e if (style == 


H3) 




return "<h3>" 




els 


e if (style == 


H4) 




return "<h4>" 




els 


e if (style == 


H5) 




return "<h5>" 




els 


e if (style == 


H6) 




return "<h6>" 





protected String renderCloseTag ( ) 
if (style == BOLD) 
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else if (style == UNDERLINE) 

return "</u>"; 
else if (style == TT) 

return "</tt>"; 
else if (style == HI) 

return "</hl>"; 
else if (style == H2) 

return "</h2>"; 
else if (style == H3 ) 

return "</h3>"; 
else if (style == H4) 

return "</h4>"; 
else if (style == H5 ) 

return "</h5>"; 
else if (style == H6) 

return "</h6>"; 




} 
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package com . thinairapps . tag . html ; 
import com. thinairapps . tag .* ; 
/** 

* A <title> tag to use in the header area of a page 
public class Title extends HTMLTag 
/** 

* @param title specify the title of the HTML doc 
*/ 

public Title (String title) throws InvalidTagException { 
super ( "title" , true) ; 
addChild(new Text (title) ) ; 

} 

} 
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package com. thinairapps . tag .html .pqa; 

import com. thinairapps. tag.*, - 
import com. thinairapps . tag .html . * ; 

/** 

* A Palm anchor with the BUTTON attribute, indicated it should 

* be rendered as a button 

* @param text the Text for the button 

* Oparam url the URL that is associated with the button 
*/ 

public class AnchorButton extends Anchor 
{ 

public AnchorButton (String text, String url) 
{ 

super ("",url,new Text (text)); 
addAttribute (new Attribute ( "BUTTON" ) ) ; 



C: \tas_source\ThirLAirServer\ . . \tag\html\pqa\DatePicker . java 1 

package com . thinairapps . tag . html . pga ; 
import com. thinairapps . tag .html . * ; 
/** 

* A Palm form element that shows a calendar view 
*/ 

public class DatePicker extends Input 
{ 

/** 

* Oparam name Name for DatePicker 
*/ 

public DatePicker (String name) 
{ 

super { "datepicker" , name); 

} 

} 
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package com. thinairapps .tag. html .pqa,- 
import com. thinairapps . tag . html .Meta ; 
/** 

* a palm header entry for controlling the displayed text in the HISTORY cache 
*/ 

public class HistoryListMeta extends Meta 
{ 

/** 

* @param text text for HistoryListMeta tag 
*/ 

public HistoryListMeta (String text) 
{ 

super ( "name" , "historylisttext " , text) ; 

} 

} 
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package com. thinairapps . tag -html .pqa; 
/** 

* Some constants to use in url building. See Palm's PQA documentation for more information. 
*/ 

public class PalmConstants 
{ 

/**This get the unique device ID for the device making the request. 
*/ 

public final static String DEVICE_ID = "%deviceid" ; 
/**This get the ZIP code for the nearest radio tower. 
*/ 

public final static String ZIP_CODE = "%zipcode"; 
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package coTn.thinairapps.tag.html -pqa; 
import com . thinairapps . tag . html . Met a ; 
/** 

* The meta tag to insert into a header to indicate the page should not 

* be "scraped" or "clipped" by the proxy, since it is already palm friendly 
*/ 

public class PalmContentMeta extends Meta 
{ 

public PalmContentMeta () 
{ 

super ( "name" , " PalmComputingPlatf orm" , "true" ) ; 

} 

} 
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package com. thinairapps . tag. html . pqa; 
import com . thinairapps . tag . html . * ; 
/** 

* A form element that display a time widget in a Palm PQA 
*/ 

public class TimePicker extends Input 
( 

/** 

* ©param name specify the name of the element 
*/ 

public TimePicker (String name) 
{ 

super ( "timepicker " , name); 

} 

} 



C:\tas_source\ThinAirServer\. .\coin\thinairapps\tag\hdml\Action. java 



1 



package com . thinairapps . tag . hdml ; 
import com . thinairapps . tag . * ; 
/** 

* Represents an ACTION tag. 

* binds a label, an optional image, and a ActionTask to the user's agent's navigational uservf 

* when the action is selected the indicated ActionTask takes place 

public class Action extends HDMLTag { 

/** defines the acceptable action types */ 
public static class Type { 
private String name; 

private Type (String n) { name = n; } 
} // end Type 



public static 
public static 
public static 
public static 
public static 
public static 
public static 
public static 
public static 
public static 
public static 



final Type SOFTl 
final Type S0FT2 
final Type SOFTS 
final Type SOFT4 
final Type S0FT5 
final Type SOFT6 
final Type S0FT7 
final Type SOFTS 
final Type ACCEPT 
final Type PREV 
final Type HELP 



new Type ("SOFTl") ; 
new Type("S0FT2") ; 
new Type("SOFT3") ; 
new Type ( " SOFT4 " ) ; 
new Type ("S0FT5") ; 
new Type("SOFT6") ; 
new Type (" SOFT? ") ; 
new Type ("SOFTS") ; 
new Type ( "ACCEPT" ) ; 
new Type ( "PREV" ) ; 
new Type ("HELP") ; 



private Type type; 
private ActionTask task; 

/** 

* create a new HDML action 

* Oparam type one of Type instances above 

* @param task specifies the way in which the action is carried out (i.e. invoke 

subprocedure ) 

public Action (Type type, ActionTask task) { 
this (type) ; 

addAttribute( new Attribute ( "TASK" , task . render () , false) ); 
this. task = task; 

} 

^* create an action with no Task useful for Choice lists 

* Oparam type one of Type instances above 

public Action (Type type) { 
super ( "ACTION" , false) ; 

addAttribute ( new Attribute ( "TYPE " , type. name, false) ); 
this. type = type; 

} 



* create a new HDML action with a destination, a label 

* and no ActionTask 

* (gparam type one of Type instances above 

* ©param label String name to map to button invoking this action 

* ©param dest String URL destination to go to when Action is executed 

public Action (Type type. String label, String dest) { 
this (type) ; 
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setLabel (label) ; 

ActionTask task = new ActionTask (ActionTask . GOSUB) ,- 
task. setDest (dest) ,- 

addAttribute{ new Attribute { "TASK" , task.render {) , false) ) ; 
this. task = task; 



* create a new HDML action with a label 

* ©param type one of Type instances above 

* ©param task specifies the way in which the action is carri« 

subprocedure) 

* ©param dest String URL destination to go to when Action is 
*/ 

public Action (Type type, ActionTask task. String label) { 
this (type, task) ; 
setLabel (label) ; 



/** 

* create a new HDML action with a label and an image 

* ©param type one of Type instances above 

* @param task specifies the way in which the action is carried out (i.e. invoke \( 

subprocedure ) 

* ©param label String name to map to button invoking this action 

* ©param image image tag to render Action (if supported by phone) 
*/ 

public Action (Type type, ActionTask task. String label, ImageTag image) { 
this (type, task) ; 
setLabel (label) ; 
setlmage (image) ; 



/** 

* set the label option 

* the text to display for this action - try to keep to <= 6 characters 

* ©param label String to map to button executing Action 
*/ 

public void setLabel (String label) { 

addAttribute ( new Attribute ( "LABEL" , label) ) ; 

} 

/** 

* set the url of the image to display for this action 

* ©param image image tag to render Action (if supported by phone) 

public void setlmage { ImageTag image) { 

addAttribute ( new Attribute (" IMAGE" , image .getSrc () ) ) ,- 

} 

/** 

* ©return Type the type for this action 
*/ 

public Type getTypeO { return type; } 
/** 

* ©return ActionTask the ActionTask for this action 
*/ 

public ActionTask getActionTask ( ) { return task; } 



} // end 
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package com . thinai rapps . tag . hdml ; 



import com.thinairapps . tag . ■ 
import j ava . ut i 1 . * ; 



Represents a ActionTask bound to ; 



Different ActionTask types have diffe: 
for a complete account of which optioi 



ChoiceEntry \ 
optioi 



see the HDML spec 

for which ActionTask types 



public class ActionTask extends HDMLTag { 

/** This inner class defines the acceptable types for Action Tasks */ 
public static class Type { 
private String name; 

private Type (String n) { name = n; } 
public String toSt ring (){ return name;} 
} // end Type 



public static final Type GO 
public static final Type GOSUB 
public static final Type PREV 
public static final Type RETURN 
public static final Type CANCEL 
public static final Type POST 
public static final Type CALL 
public static final Type NOOP 

private static final String mism; 

Type"; 
private Type type; 



= new Type ("GO") ; 
= new Type ( "GOSUB" ) ; 
= new Type ( "PREV" } ; 
= new Type ("RETURN") ; 

= new Type ("CANCEL") ; 
= new Type ( "POST" ) ; 
= new Type ( "CALL" > ; 
= new Type ("NOOP") ; 

Itch = 



'this option is not valid for this ActionTask 



* create a ActionTask of a specific type 

* @param t create an ActionTask of this type 
*/ 

public ActionTask (Type t) { 
super(t.name, false); 
type = t; 



* set the dest option 

* the URL of the card to display or invoke in the GO, GOSUB, RETURN, or CANCEL 

ActionTasks 

* @param url String destination for this action task 
*/ 

public void setDest (String url) { 

if (type == GO II type == GOSUB | | type == RETURN j \ type == CANCEL) 
; // ok 



throw new InvalidHDMLException (mismatch) ; 
addAttribute ( new Attribute ( "DEST" , url, false) ); 



* specifies a single name=value variable pair 

* or sub (in the case of SUB) activity. 

* each pair will be appended to the URL-style 

* (Sparam name String variable name 

* @param value String variable default value 
*/ 



■et in the current (in the i 
; String value 
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public void setVar (String name, String value) { 

if (type == GO | | type == GOSUB) 
; // ok 

else 

throw new InvalidHDMLException (mismatch) ; 

Attribute vars = getAttribute ( "VARS " ) ; 
String varString = name + "=" + value + "&"; 

if (vars != null) 

varString = vars . getValue () + varString; 

// overwrite the old VARS Attribute 
addAttribute (new Attribute ( "VARS" , varString) ) ; 
vars = null; 



/** 

* set the RECEIVE option 

* when invoking a card with the GOSUB ActionTask the RECEIVE option specifies the names 

of the 

* variables to assign the return values to 

* based on position 

* ©param variables list of variables to receive values from a GOSUB ActionTask 
V 

public void setReceiveList (String variables [] ) { 

if (type != GOSUB) 

throw new InvalidHDMLException (mismatch) ; 

StringBuffer sb = new StringBuf fer (12 8) ; 
for (int i = 0; i < variables . length; i++) { 

sb.append( variables [i] ); 

sb . append ( " ; " ) ; 

} 

String s = sb.toString () . trimO ; 

// remove that trailing ; 

s = s. substring (0, s. length () - 1); 

addAttribute ( new Attribute ("RECEIVE" , s) ); 



/** 

* set the RETVALS option 

* when returning from a sub-activity with the RETURN ActionTask, the RETVALS option 

specifies 

* the values to return to the invoking activity 

* values are positional 

* ©param retvals array of values to return from the task 
*/ 

public void setRetvals (String retVals[]) { 

if (type != RETURN) 

throw new InvalidHDMLException (mismatch) ; 

StringBuffer sb = new StringBuf fer ( 12 8 ) ; 
for (int i = 0; i < retVals . length; i++) { 

sb.append{ retVals[i] ); 

sb . append ( " ; " ) ; 

} 

String s = sb . toString ( ) . trim ( ) ; 

// remove that trailing ; 

s = s. substring (0, s. length () - 1); 



} 
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addAttribute ( new Attribute ( "RETVALS " , s) ); 



/** 

* set the NEXT option 

* the next option specifies the destination to go to after the sub-activity returns 

* @param destination URL to go to when the action is executed 
*/ 

public void setNext (String destination) { 

if (type != GOSUB) 

throw new InvalidHDMLException (mismatch) ; 

addAttribute ( new Attribute ( "NEXT" , destination) ); 

} 



/** 

* set the CANCEL option 

* when invoking a sub-activity with the GOSUB ActionTask, the CANCEL option specifies 

the 

* destination to go to if the sub-activity is cancelled 

* Oparam destination URL to go to when the action is executed 

■M public void setCancel (String destination) { 

if (type != GOSUB) 

throw new InvalidHDMLException (mismatch) ; 

addAttribute ( new Attribute ( "CANCEL" , destination) ); 
} 



/** 

* the SENDREFERER option specifies whether the user agent should indicate the URL of the 

* referring deck when requesting the DEST, NEXT, CANCEL decks from the server 

* ©param boolean if true then send referer URL 
*/ 

public void setSendReferer (boolean b) { 

if (type == GO | | type == GOSUB) 

; // ok 
else 

throw new InvalidHDMLException (mismatch) ; 
String val = ((b) ? "true" : "false"); 

addAttribute ( new Attribute ( "SENDREFERER" , val, false) ); 

} 



/** 

* set the friend option to indicate that the sub-activity is friendly 

* @param boolean if true then the sub-activity is friendly 

public void setFriend (boolean b) { 

if (type != GOSUB) 

throw new InvalidHDMLException (mismatch.) ; 

String val = ((b) ? "true" : "false"), - 

addAttribute ( new Attribute ( "FRIEND" , val, false) ) ,- 

} 



* set the clear option to indicate that the sub-activity is clearly 
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* used by RETURN and CANCEL to unset all calling activity's variables 

* ©param boolean if true clear the subactivity 
*/ 

public void setClear (boolean b) { 

if (type == RETURN | | type == CANCEL) 

; // Ok; 
else 

throw new InvalidHDMLException (mismatch) ; 

String val = ((b) ? "true" : "false"); 
addAttribute( new Attribute ( "CLEAR" , val, false) ); 

} 



/** 

* set the NUMBER option - specifies the phone number for a CALL ActionTask 

* ©param value the phone number String 
*/ 

public void setNumber (String value) { 

if (type != CALL) 

throw new InvalidHDMLException (mismatch) ; 

addAttribute ( new Attribute ( "NUMBER" , value) ); 

} 

/** 

* ©return String typename 
*/ 

public String getTypename () { return type. name; } 



/** 

* override here so you can embed this tag within the attribute list of an Action 
*/ 

protected String renderOpenTag ( ) { 

StringBuffer output = new StringBuf f er ( ) ; 
output. append (name) ; 

Enumeration enum = attributes . elements () ; 
while( enum.hasMoreElements 0 ) 
output . append ( " " + ((Attribute) enum . nextElement ())- render ()) ; 

return output . toString () ; 



} // end 
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package com. thinairapps . tag .hdml ; 
import com. thinairapps . tag. * ; 

* The &1 t; anchor > element anchors a task to a string of formatted text, often called a 

link. 

* You can specify a link within any formatted text or image. Any one of ActionTasks must be 

* bound to the Anchor for it to be bound to a button on the device and perform some action 

when 

* selected. 
*/ 

public class Anchor extends HDMLTag { 
/** 

* Create an Anchor without a TAKS or DEST 
*/ 

public AnchorO { super ( "A" , true) ; } 
/** 

* Create an Anchor of the given type, destination, and text label 

* ©param type any one of 8 ActionTasks bound to the link 

* ©param dest destination for the action type 

* ©param text label for link 
*/ 

r public Anchor (Act ionTask. Type type, String dest. Text text) { 

super ( "A" , true) ; 
S addAttribute ( "TASK" , type . toString ( ) ) ; 

^==^ addAttribute ("DEST", dest) ; 

addChild(text) ,- 

} 

* Set the task for this anchor 

T1 * ©param type specifies the way in which the action is carries out (i.e. invoke 
subpr oc edur e ) 

*/ 

public void setTask (ActionTask.Type type) { 
addAttribute ( "TASK" , type . toString () ) ; 

3 J 

3 * Set the destination of this action 
.„:, * @param dest URL destination 
*/ 

public void setDest ( String dest) { 
addAttribute ( "DEST" , dest ) ; 

} 



} // end 
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package com . thinairapps . tag . hdml ; 
/** 

* A line-break tag akin to <BR> in HTML 
*/ 

public class Break extends HDMLTag { 

/** create a new line-break tag */ 
public Break 0 { 

super ( "BR" , false) ; 

} // end 
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package com. thinairapps . tag . hdml ,- 
import com. thinairapps . tag .* ; 
/** 

* The base class for all HDML cards 
*/ 

public abstract class Card extends HDMLTag { 
/** 

* Build a new Card 

* ©param typeName the type of card to build 

* @param boolean should the card append a closing tag i.e. <something /> or leave the 

* tag open <something> and wait for a </something> later 
*/ 

protected Card (String typeName, boolean closingTag) { 
super (typeName, closingTag) ; 

} 



/** 

* set the name option of this card 

* if the card has a name then it can be referreed to as a fragment in a destination 

* ©param name the String name of the card 
*/ 

public void setName (String name) { 

addAttribute ( new Attribute ( "NAME name) ) ; 

} 



* set the title option of the card 

* if no title is specified the first text line of the card is used as the title 

* title is used for: a suggested bookmark name 

* a text entry prompt 

* @param title String title to be displayed by some browsers at the top of the card 
*/ 

public void setTitle (String title) { 

addAttribute ( new Attribute ( "TITLE" , title) ) ; 

} 

/** 

* ©return String title of the card 
*/ 

public String getXitleO { 

Attribute att = getAt tribute ( "TITLE" ) ; 
return att . getvalue () ; 

} 

/** 

* specify a URL to use when bookmarking the card 

* the default is the URL of the current card 

* this option is used to force the bookmark to go to another card (like a NODISPLAY ^ 

card) that sets up valirables 

* instead of the current card 

* @param url String to use when bookmarking the card 
*/ 

public void setBookmark (String url) ( 

addAttribute ( new Attribute ( "BOOKMARK" , url) ); 

} 



} // end 
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package com. thinairapps . tag .hdml ; 
import com. thinairapps .tag. * ; 
/** 

* Represents the CHOICE card. 

* <p> 

* Lets users pick from a list of choices - the initial display content is shown to the user 

* followed by a list of choices. Each choice can have one line of formatted text 

* text defaults to line mode but may optionally be wrapped 
*/ 

public class ChoiceCard extends Card { 

public static class Method { 
private String name; 

private Method (String n) { name = n,- } 

public static final Method NUMBER = new Method { "number ") ; 
public static final Method ALPHA = new Method ( "alpha" ) ; 



/** 

* create a choice card with a line of text 

* @param text String to display above the list of choices 
*/ 

public ChoiceCard (String text) { 
super ( "CHOICE" , true) ; 
try { 

addChild( new Format tedLine ( text , true) ) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e . getMessage () ) ; 



/** 

* create a choice card with no text and all defaults 
*/ 

public ChoiceCard 0 { 

super ("CHOICE", true) ; 

} 



/** 

* add the display text to this ChoiceCard 

* @param text the label 
*/ 

public void addText (FormattedLine text) { 
try { 

addChild(text) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e . getMessage ()) ; 



/** 

* set the method option for this ChoiceCard 

* Oparam method defaults to method=NUMBER 
*/ 

public void setMethod (Method method) { 

addAttribute ( new Attribute ( "METHOD" , method, name) ) ,- 

} 



/** 

* set the KEY option 
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* ©param key indicates the name of the variable in the current activity to be set by 
this entry 

*/ 

public void setKey (String key) { 

addAttribute ( new Attribute ( "KEY" , key) ) ; 



/** 

* set the DEFAULT 

* Oparam def indicates the name of the variable in the current activity to be set by nf 

this entry 

*/ 

public void setDefault (String def) { 

addAttribute ( new Attribute ( "DEFAULT" , def) ); 

} 



/** 

* set the key and default options 

* indicates the name of the variable to be set to the choice entry value 

* when that ce is picked 

* an entry is picked when any action (ACCEPT, PREV, SOFT*) is selected 

* default indicates the default value of the variable key - when the card is entered 

* if the variable keu is not set it will be assigned the default value 

* otherwise default is ignored 

* ©param key indicates the name of the variable in the current activity to be set by ^ 

this entry 

* ©param def indicates the name of the variable in the current activity to be set by a? 

this entry 

*/ 

public void setKey (String key. String def) { 
addAttribute ( new Attribute ( "KEY" , key) ) ; 
addAttribute ( new Attribute ( "DEFAULT" , def) ); 



/** 

* ikey indicates the name of the variable to be set to the entru index when 

* an entry is picked - the entry index is the positiion of the currently-selected 

* choice entry in the choice card 

* an index of 0 indicates that no choice entry is selected 

* idefault indicates the default selected entry 

* if ikey is not specified, idefault will be applied every time the card is entered 

* ©param key indicates the name of the variable in the current activity to be set by kT 

* @param def indicates the name of the variable in the current activity to be set by 
*/ ^'^ 

public void setlKey (String key. String def) { 
addAttribute ( new Attribute (" IKEY" , key) ) ; 
addAttribute ( new Attribute (" IDEFAULT" , def) ) ; 



/** 

* add a choice entry to this card 

* ©param ce the ChoiceEntry to add 
*/ 

public void addChoiceEntry (ChoiceEntry ce) { 
try { 

addChild(ce) ,- 
} catch (Exception e) { 

throw new InvalidHDMLException (e .getMessage ( ) ) ; 



C : \tas_source\ThinAirServer\ . . \thinairapps\tag\hdml\ChoiceCard. java 



3 



/** 

* add an action to this Card 

* when an action is specified for a card it overrides any deck actions of that type 

* while the card is visible 

* N.B. all actions must precede any line of text in the hdml document 

* ©param action to bind to some button 
*/ 

public void addAction (Action action) { 
try { 

addChild (action) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e .getMessage ( ) ) ; 




/** 

* choice cards must have one or more choices 

* implement that checking here 
*/ 

public String render () { 

if (getChildrenO . size () ==0) 

throw new InvalidHDMLException ( "Choice cards must have >=' 1 Choice Entry"); 

return super . render ( ) ; 

} 



M| // end 
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package com . thinairapps . tag . hdml ; 

import com . thinairapps . tag . * ; 
import java.util.*; 

/** 

* Represents a single CE choice entry within a Choice card. 

* In addition to text you can specify a value to be assigned to the variable 

* named in the parent choice card's key option 
*/ 

public class ChoiceEntry extends HDMLTag { 
/** 

* create a choice Entry with all defaults 

* ©param text label for this Choice Entry 
*/ 

public ChoiceEntry (String text) { 
thisO ; 
try { 

addChild{ new FormattedLine (text) ) ; 
} catch (Exception e) { 

throw new InvalidHDMLExcept ion (e .getMes sage ()) ; 

} 

} 



/** 

* create a choice Entry with a name and dest 

* @param text label for this Choice Entry 

* @param dest URL destination to go to when the choice is selected 
*/ 

public ChoiceEntry (String text. String dest) { 
thisO ; 
try { 

addChild( new FormattedLine (text) ) ; 
setDest (dest) ,- 
} catch (Exception e) { 

throw new InvalidHDMLException(e.getMessage (} ) ; 

} 

} 



/** 

* create a choice Entry with a name, dest, and value 

* ©param text label for this Choice Entry 

* @param dest URL destination to go to when the choice is selected 

* @param value to be assigned to the variable named in the choice card's key option 
*/ 

public ChoiceEntry (String text, String dest. String value) { 
thisO ; 
try { 

addChild( new FormattedLine (text) ) ,- 
setDest (dest) ; 
setvalue (value) ; 

} catch (Exception e) { 

throw new InvalidHDMLException (e .getMessage ( ) ) ; 

} ^ 
/** 

* create a choice Entry with no text, value, or destination 
*/ 

public ChoiceEntry () { 
super ("CE", false); 

} 
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/** 

* add the display text to this ChoiceEntry 

* @param text String label for this choice 
*/ 

public void addText (FormattedLine text) { 
try { 

addChild( text ) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e .getMessage ( ) ) ; 




/** 

* set the value to be assigned to the variable named in the choice card's key option 

* @param value 
*/ 

public void setvalue (String value) { 

addAttribute ( new Attribute ( "VALUE" , value) ); 

} 



/** 

* adds an ActionTask to this ChoiceEntry and sets the dest attribute 

* ©param dest URL destination to go to when the choice is selected 
*/ 

public void setDest (String dest) { 

if (getAttribute ( "TASK" ) == null) addAttribute ( new Attribute ( "TASK" , "GOSUB") ) ; 
addAttribute ( new Attribute ( "DEST" , dest) ); 



/** 

* set the ActionTask associated with this ChoiceEntry 

* be sure to include all attributes of the Task as attributes of the ChoiceEntry 

* ©param task ActionTask 
*/ 

public void setActionTask (ActionTask task) { 

addAttribute ( new Attribute ( "TASK" , task.getTypenarae ( ) , false) ) ,- 
Enumeration enum = task. getAttributes () .elements () ; 

wh i 1 e ( enum . ha sMoreE 1 ement s { ) ) 

addAttribute ( (Attribute) enum.nextElement ( ) ) ; 

} 



} // end 



C: \tas_source\ThinAirServer\ . . \thinairapps\tag\hdTiil\DisplayCard . java 



1 



package com. thinairapps . tag . hdml ; 
import com. thinairapps .tag. *; 
/** 

* the DISPLAY card is used to give information for the user to read 

* DISPLAY cards can also contain actions 
*/ 

public class DisplayCard extends Card { 
/** 

* create a display card 
*/ 

public DisplayCard { ) { 

super ("DISPLAY", true) ; 

} 



/** 

* create a display card 

* Oparam text String label 
*/ 

public DisplayCard (String text) { 
thisO ; 

addText ( new FormattedLine (text) ) ; 

} 



/** 

* add an action to this Card 

* when an action is specified for a card it overrides any deck actions of that type 

* while the card is visible 

* N.B. all actions must precede any formatted lines in the hdml document 

* @param action to bind to some button on the device 
*/ 

public void addAct ion (Action action) { 
try { 

addChild (action) ; 
} catch (Exception e) ( 

throw new InvalidHDMLException (e.getMessage () ) ; 




/** 

* add a line of formatted text to this DISPLAY card 

* ©param line text to add to card 
*/ 

public void addText (FormattedLine line) { 
try { 

addChild (line) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e . getMessage ()) ,- 

} 

} 



} // end 
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package com. thinairapps . tag . hdral ; 
import com. thinairapps . tag. * ,- 
/** 

* Represents the ENTRY card. 

* <p> 

* Lets users input an optionally formatted character string - the display content 

* is shown to the user, followed by an area to input characters 
*/ 

public class EntryCard extends Card { 
/** 

* create an entry card with String text 

* ©param text String text to add to top of card 
*/ 

public EntryCard (String text) { 
super ( "ENTRY" , true) ; 
addText ( new FormattedLine (text) ) ; 

} 

/** 

* create an entry card with String text 

* ®param text String text to add to top of card 

* ©parara key indicates the name of the variable in the current activity to be set by 

this entry 

* ©param action to bind to some button on the device 
*/ 

public EntryCard (String text. String key. Action action) { 
super ( "ENTRY" , true) ; 
setKey(key) ; 
addAction (action) ; 

addText ( new ForTnattedLine (text ) ) ; 

} 



/** 

* create a choice card with no text, key, or action! 
*/ 

public EntryCard () { 

super ( "ENTRY" , true ) ; 

) 



/** 

* set the KEY option 

* (Sparam key value of the KEY attribute 
*/ 

public void setKey (String key) { 

addAttribute ( new Attribute ( "KEY" , key) ) ; 



/** 

* set the DEFAULT option 

* @param def indicates the name of the variable in the current activity to be set by 

this entry 

*/ 

public void setDefault (String def) { 

addAttribute ( new Attribute ( "DEFAULT" , def) ) ; 

} 



* set the KEY and DEFAULT options 
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* indicates the name of the variable in the current activity to be set by this entry 

* default indicates the default value of the variable key - when the card is entered 

* if the variable keu is not set it will be assigned the default value 

* otherwise default is ignored 

* N.B. default must conform to the format optioin if that is set 

* @param key value of the KEY attribute 

* ©param def indicates the name of the variable in the current activity to be set by 

this entry 

*/ 

public void setKey (String key. String def) { 
addAttribute ( new Attribute ( "KEY" , key) ) ; 
addAttribute { new Attribute ( "DEFAULT" , def) ) ; 



/** 

* set the FORMAT optiion - used to specify a format for user input entries 

* @see http://www.w3c.org/TR/hdml20-6.html for format codes 

* ©param format the format String, i.e. 'm*' for all alphanumeric defaulting to ^ 

lower-case 

*/ 

public void setFormat (String format) { 

addAttribute ( new Attribute ( "FORMAT" , format) ) ; 



/** 

* set the NOECHO option on the text field 

* Oparam b if true then chars will not be echoed 
*/ 

public void setNoEcho (boolean b) { 

String val = ((b) ? "true" : "false"), - 

addAttribute ( new Attribute ( "NOECHO" , val, false) ) ; 

} 



/** 

* set the EMPTYOK option on the text field 

* ®param b if true then an empty input will be accepted 
*/ 

public void setEmptyOK (boolean b) { 

String val = ((b) ? "true" : "false"); 

addAttribute ( new Attribute ( "EMPTYOK" , val, false) ) ; 

} 

/** 

* add an action to this Card 

* when an action is specified for a card it overrides any deck actions of that type 

* while the card is visible 

* N.B. all actions must precede any line of text in the hdml document 

* ©param action to bind to some button on the device 
*/ 

public void addAction (Action action) { 
try { 

addChi Id (action) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e . getMessage ( ) ) ; 

} 

} 



/** 

* add a line of formatted text to this DISPLAY card 

* @param text String text to add to top of card 
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*/ 

public void addText (FormattedLine line) { 
try { 

addChild(line) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e .getMessage ( ) ) ,- 
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package com. thinairapps . tag.hdml ; 
import com. thinairapps . tag . * ; 
/** 

* a subclass of DISPLAY card for displaying errors to the user 
*/ 

public class ErrorCard extends DisplayCard { 
/** 

* create an error card 

* (Sparam String error message 
*/ 

public ErrorCard (String error) { 
super ( ) ; 

addText ( new FormattedLine (error, true) ) ; 

} 

* create an error card 

* @param String error message 

* ©param String path for ok button 

* @param String label on ok button 
*/ 

public ErrorCard (String error. String path, String label) { 
super ( ) ; 

ActionTask task = new ActionTask (ActionTask.GO) ; 
task. setDest (path) ; 

addAction( new Act ion (Action. ACCEPT, task, label) ) ; 
addText ( new FormattedLine (error, true) ); 
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package com. thinairapps . tag . hdml ; 
import com . thinairapps . tag . * ; 

* A line of text, with formatting directives, to add to the card 
*/ 

public class FormattedLine extends HDMLTag { 

/** Instances of this class represent the acceptable alignments */ 
public static class Alignment { private Alignment () { ; } } 
public static Alignment LEFT = new Alignment {); 
public static Alignment CENTER = new Alignment!); 
public static Alignment RIGHT = new Alignment!); 

private String lineFormat; 
private String alignmentFormat ; 

/** 

* create a line with no text - a break 
*/ 

public FormattedLine ( ) { 
super ( "<BR>" , false); 

} 



/** 

* create a line of formatted text 

* @param content String content of the text line 

* @param align one of three alignment instances above 
*/ 

public FormattedLine (String content. Alignment align) { 
super (content, false); 

if (align == RIGHT) 

alignmentFormat = "<RIGHT>"; 
else if (align == CENTER) 

alignmentFormat = "<CENTER>"; 

} 



/** 

* create a line of formatted text with default alignment (LEFT) 

* @param content String content of the text line 

* ©param wrap if true then the text will wrap around the screen 
*/ 

public FormattedLine (String content, boolean wrap) { 
super (content, false); 

lineFormat = (wrap) ? "<WRAP>" : "<LINE>"; 

} 



/** 

* create a line of formatted text with all defaults 

* @param content String content of the text line 
*/ 

public FormattedLine {String content) { 
super (content, false); 

// lineFormat = alignmentFormat = null; 

} 



/** 

* set the line format mode 

* ©param b if true then the text will wrap around the screen 
*/ 

public void setWrap (boolean b) { 

lineFormat = (b) ? "<WRAP>" : "<LINE>"; 

} 
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/** 

* set the alignment format mode 

* Oparam align one of three alignment instances above 
*/ 

public void setAlignment (Alignment align) { 
if (align == RIGHT) 

alignmentFormat = "<RIGHT>"; 
else if (align == CENTER) 

alignmentFormat = "< CENTER >"; 

} ■ 



/** 

* stick the text content in the name String 

* override this to just render the name (i.e. the text content) 

* without start or end tags 
*/ 

public String render () { 

if (lineFormat == null && alignmentFormat == null) return getNameO; 

if (lineFormat == null) lineFormat = ""; 

if (alignmentFormat == null) alignmentFormat = " " ; ^ 
return lineFormat + alignmentFormat + getNameO; 

) 



} // end 
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package com . thinairapps . tag . hdml ; 
import com. thinairapps . tag .* ; 
/** 

* base class for all tags in the HDML tag hierarchy 
*/ 

public abstract class HDMLTag extends Tag { 
/** 

* Create a new HDML tag that may optionally close itself 

* ®param name for this card 

* Oparam closingTag if true then this tag closes itself 
*/ 

public HDMLTag (String name, boolean closingTag) { 
super(name, closingTag); 

} 

/** 

* Create a HDML tag that closes itself 

* @param name for this card 
*/ 

public HDMLTag (String name) { 
super (name, false) ,- 

} 

Iff // end 



C: \tas_source\ ■ ■ \thinairapps\tag\hdml\HDMLiTagDocument . java 



1 



package com . thinairapps . tag . hdml ; 
import com. thinairapps . tag . * ; 
/** 

* Represents an entire deck of an hdml document. 

* <p> 

* Contains the topmost <HDML> tag, any cards, AND any actions, and the </HDML> 
*/ 

public class HDMLTagDocument extends TagDocument { 
/** 

* create a new HDMLTagDocument with markable and public set to true 
*/ 

public HDMLTagDocument ( ) { 
this (true, true) ; 

} 



/** 

* create a new HDMLTagDocument 

* with settings for MARKABLE and PUBLIC 

* ©param markable if true then this document is markable 

* @param pub then this document is public 
*/ 

public HDMLTagDocument (boolean markable, boolean pub) { 
superC'HDML" , " text/x-hdml " ) ; 

getRoot () .addAt tribute ( new Attribute ( "VERSION" , "3.0", false) ) ; 

setPublic (pub) ; 
setMarkable (markable) ; 

} 

/** 

* set the time to live option 

* ©param seconds number of seconds that the deck will be cached by the user agent 

* after reception 
*/ 

public void setTimeToLive ( int seconds) { 

getRoot () .addAt tribute ( new Attribute ( "TTL" , String . valueOf ( seconds ) , false) ) ,- 

} 



/** 

* set the public option 

* Oparam b indicates whether deck access control has been enabled for this deck 
*/ 

public void setPublic (boolean b) { 

String val = ((b) ? "true" : "false"), - 

getRoot () -addAttribute ( new Attribute ( "PUBLIC" , val, false) ) ; 

} 

/** 

* set the access domain of this document 

* @param url String domain name, i.e. something.com the access domain is suffix-matched 

against the domain 
•* name of a referring url 
*/ 

public void setAccessDomain (String url) { 

if (getRoot 0 .getAttributet "PUBLIC") == null) 

throw new InvalidHDMLException ( "The public option must be set to true before an 
Access Domain can be set"); 

getRoot () .addAttribute ( new Attribute ( "ACCESSDOMAIN" , url) ) ; 

) 
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/** 

* set the access path of this document 

* @param path String can be a relative url , i.e. /thinair/docs 
*/ 

public void setAccessPath (String path) { 

if (getRoot 0 .getAttribute { "PUBLIC" ) == null) 

throw new InvalidHDMLException ( "The public option must be set to true before an 
Access Path can be set"); 

getRoot 0 .addAttribute( new Attribute ( "ACCESSPATH" , path) ) ; 

} 



/** 

* set the markable option 

* ©param b specifies whether the cards in this deck can be bookmarked or not 
*/ 

public void setMarkable (boolean b) { 

if ( b == true && (getRoot 0 .getAttribute { "PUBLIC" ) == null)) 

throw new InvalidHDMLException ( "The public option must be set to true before an 
Markable can be set to true"); 

String val = ((b) ? "true" : "false"); 

getRoot () .addAttribute ( new Attribute ( "MARKABLE" , val, false) ); 

} 



/** 

* add an action to the TaggedDocuraent 

* actions added at this level remain in effect for the life of the deck 

* when an action is specified for a card it overrides any deck actions of that type 

* while the card is visible 

* @param action an Action bound to some button on the device 
*/ 

public void addAct ion (Action action) { 
try { 

getRoot 0 .addChild (action) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e .getMessage ()) ; 

} 

} 

/** 

* add a Card to this Tagged Document 

* ©param c Card to add to the document 
*/ 

public void addCard(Card c) { 
try { 

getRoot () .addChild (c) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e .getMessage ()) ; 

} 

} 



/** 

* when you go to render - there must be >= 1 card added to the deck 
*/ 

public String render ( ) { 

if (getRootO .getChildrenO -sizeO > 0) 
return super . render ( ) ; 

else 

throw new Inval idHDMLExcept ion ( "One or more cards must be added to a deck before ^ 
rendering" ) ; 

} 

} // end 
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package com . thinairapps . tag . hdml ; 
import com. thinairapps. tag.*; 
/** 

* An image tag, supported only by some HDML -rendering device 
*/ 

public class ImageTag extends HDMLTag { 
/** 

* Create a new HDML Image 

* ©param url location of the device 

* ©param altText to appear if no image can be displayed 
*/ 

public ImageTag (String url, String altText) { 
superC'IMG", false) ; 

addAttribute ( new Attribute ( "SRC" , url) ) ; 
addAttribute ( new Attribute ( "ALT" , altText) ) ,- 

} 

/** Create an imagae tag with no url or alt text */ 
public ImageTag 0 { 

super("IMG", false); 

} 

/** 

* @param iconName name for the icon 
*/ 

public void setlcon (String iconName) { 

addAttribute (new Attribute (" ICON" , iconName) ) ; 

} 

/** 

* Oparam altText to be displayed if the device does not support images 
*/ 

public void setAltText (String altText) { 

addAttribute ( new Attribute { "ALT" , altText) ); 

} 



/** 

* set the NAME option 

* alternative internal graphic representation for the image 

* if an image by name exists it will be used - otherwise one will be downloaded 

* from the src URL 

* this allows user-agents to provide an internal set of generic images identified by 

* ®param name for this image tag 
*/ 

public void setName (String name) { 

addAttribute ( new Attribute ( "NAME" , name) ); 

} 

/** 

* ©return String url for this image 
*/ 

public String getSrcO { return (String) getAttribute ( "SRC " ) . getValue ( ) ; } 
} // end 
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package com . thinairapps . tag . hdml ; 
/** 

* represents an invalid tag or document layout 
*/ 

public class InvalidHDMLException extends RuntimeException { 
/** 

* Create InvalidHDMLException 

* @param message carried inside the exception 
*/ 

public InvalidHDMLException (String message) { 
super (message) ; 

} 

/** create an InvalidHDMLException with no message */ 
public InvalidHDMLException 0 { 
super ("invalid HDML used" ) ; 

} 

} // end 
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package com. thinairapps . tag.hdml ; 
import com. thinairapps . tag .* ; 
/** 

* The NODISPLAY card DOES NOT give information for the user to read 

* <p> 

* It immeditately executes its ACCEPT or PREV action -- all other 

* actions are ignored - this implementation will throw an exception 

* if any other action type is entered 
*/ 

public abstract class NoDisplayCard extends Card { 

* create a display card 
*/ 

public NoDisplayCard ( ) { 

super ("NODISPLAY", true); 

} 

/** 

* add an action to this Card 

* when an action is specified for a card it overrides any deck actions of that type 

* while the card is visible 

* ©param action to bind to some button on the device 
*/ 

public void addAction (Action action) { 

Action. Type type = action .getType {) ; 
if (type == Action. ACCEPT | | type == Action. PREV) 
; // ok 

else 

throw new InvalidHDMLException ( "Only Accept and Prev actions are valid for a kf 
NODISPLAY Card"); 

try { 

super. addChild (action) ; 
} catch (Exception e) { 

throw new InvalidHDMLException (e .getMessage ()) ; 

} 

} 

} // end 
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package com. thinairapps . tag .hdml ; 
import com . thinairapps . tag . * ; 
/** 

* Represents the ENTRY card 

* <p> 

* let users input an optionally formatted character string - the display content 

* is shown to the user, followed by an area to input characters 
*/ 

public class PasswordEntryCard extends EntryCard { 

/** create a blank PasswordEntryCard with no destination */ 
public PasswordEntryCard ( ) { 
super ( ) ; 

setNoEcho (true) ,- 

} 



/** 

* create a password entry card 

* upon completion of password the next card in the deck 

* is identified by dest 

* ©param dest maps dest to $ (username) 
*/ 

public PasswordEntryCard (String dest) { 
this (dest, "$ (username) ") ; 

} 



/** 

* create a password entry card 

* upon completion of password the next card in the deck 

* is identified by dest 

* @param dest String url to go to when the password is entered 

* @param username name of user of this card 
*/ 

public PasswordEntryCard (String dest. String username) { 
super 0 ; 

setName ( "passwordCard" ) ; 
setKey( "password") ; 
setTitle { "Enter Password:"); 

ActionTask task = new ActionTask (ActionTask.GOSUB) ; 
task. setVar ( "password" , "$ (password) ") ; 
task. setDest (dest) ; 

addAction( new Action (Act ion. ACCEPT, task, "Next") ) ; 

setNoEcho (true) ; 
setEmptyOK( false) ; 

if (username != null) addText ( new FormattedLine ( "User : "+username) ) ; 
addText { new FormattedLine ( "Password: " ) ); 

} 



/** 

* create a password entry card 

* upon completion of password the next card in the deck 

* is identified by dest 

* Oparam dest String url to go to when the password is entered 

* ©param username name of user of this card 
*/ 

public PasswordEntryCard (String dest. String key, String username) { 
super ( ) ; 
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setName { "passwordCard" ) ; 
setKey (key) ; 

setTitle ( "Enter Password:"); 

ActionTask task = new ActionTask (ActionTask . GOSUB) ; 
task . setVar ( "password" , " $ (password) " ) ; 
task. setDest (dest) ; 

addAction( new Action (Action. ACCEPT, task, "Next") ); 

setNoEcho (true) ; 
setEmptyOK (false) ; 

if (username != null) addText ( new FortnattedLine ( "User : "+username) ) ; 
addText ( new FormattedLine ( "Password :" ) ) ; 

} 



} // end 
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package com. thinairapps . tag . hdml ; 
/** 

* This class allows you to insert an arbitrary String 

* into a HDML Deck. 
*/ 

public class Text extends HDMLTag { 
/** 

* Create a new Text Object with the given String 

* ©parara text String text for this tag 
*/ 

public Text (String text) { 
super (text, false) ; 

} 

/** 

* ©return String you used to define this Text Object 
*/ 

public String getTextOnly () { 
return getName ( ) ; 

} 

/** 

* ©return Sting HDML markup for this object 
*/ 

ifl public String render () { 
return getName ( ) ; 

} 

;} // end 
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/** 

* @(#)WAPDevice. java 
*/ 

package com. thinairapps .platform. device ; 

import j avax . servlet . * ; 
import j avax. servlet. http.*; 

/** 

* ThinAirApps abstraction for a WAP device 
*/ 

public class WAPDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 2962217947595361097L; 

/** 

* Constructs a new <code>WAPDevice</code> instance of the type represented by profile. 

* ©param profile <code>WAPDeviceProf ile</code> prototype for this device instance 
*/ 

WAPDevice (WAPDeviceProf ile profile) { 
super (profile) ; 

} 

/** 

* Retrieves the content encoding type supported by this device. 

* ©return <code>String</code> content type supported by this device. 
*/ 

public String getContentType {) { 

return WAPDeviceProf ile .WML_USER_CONTENT_TYPE ; 

} 

\6 // end 
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* @(#)WAPDeviceProf ile. java 
*/ 

package com . thinairapps .platform . device ; 

import javax. servlet . * ; 
import javax. servlet . http. * ; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>DeviGe</code> 

factory for WAP devices 

*/ 

public class WAPDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
Static final long serialVersionUID = 334116101350320763L; 

/** name of this device profile */ 

public static final String NAME = "TA_WAP" ; 

/** content type accepted by all devices matching this profile 
static final String WML_USER_CONTENT_TYPE = " text/vnd . wap . wml " ; 

/** alternate content type accepted by all devices matching this profile */ 
static final String WML_USER_CONTENT_TYPE2 = " text/x- wap . wml " ; 

/** alternate mime type indicating wml compliance */ 

static final String WML_USER_CONTENT_TYPE3 = "application/vnd . wap . wmlc" ; 
/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 
ifl creates. 

* ©return <code>Class</code> of the <code>WAPDevice</code> instances that this profile 

generates . 

*/ 

public Class getDeviceClass () { return new WAPDevice (this) .getClass ( ) ; } 



* Retrieves the friendly name of this device type descriptii 

* ©return <code>String</code> A friendly name callers can u 

DeviceProf ile</code> 

*/ 

public String getName () { return NAME; } 



Determines whether the actual device making a request is of the type represented by 
<code>WAPDeviceProf ile</code> . 

Oparam request the actual <code>ServletRequest</code> received by the ThinAir Server 

©return <code>boolean</code> true if the requesting device is of type <code>WAPDevi< 
</code>, false otherwise. 

/ 

iblic boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check Accept header 
HttpServletRequest request = (HttpServletRequest) req; 
String accept = request . getHeader ( "Accept ") ; 

return ( (accept != null ) && (accept . indexOf ("wap. wml") >= 0)); 
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return false; 

} 



/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the ^ 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest) req; 
WAPDevice device = new WAPDevice (this) ; 

// need to check for presence of x-up-subno, if not there, do not set GUID 

String tempGUID = request .getHeader ( "x-up-subno" ) ; 

if (tempGUID != null) device . setGUID ( NAME + ":" + tempGUID }; 

// ACCEPT 

device . setAccept (request . getHeader ( "Accept " ) ) ; 
// USER- AGENT 

String tempUserAgent = request . getHeader ( "User- Agent ") ; 

device. setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// COOKIES 

device. setCookies (request .getCookies ()); 



return device; 

} 



/** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconf igure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant. 

* ©param guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

WAPDevice device = new WAPDevice (this) ; 
device . setGUID (guid) ; 

// inintialize properties to NO_VALUE 
device . setUserAgent ( STRING_NO_VALUE ) ; 

return device; 

} 



} // end 
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/** 

* @(#)UPWAPDeviceProfile. java 
*/ 

package com. thinairapps . platform . device ; 

import j avax . servlet . * ; 
import j avax. servlet . http. * ; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for up . com WAP phones 

*/ 

public class UPWAPDeviceProf ile extends WAPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -2773505273328761059L; 



/** name of this device profile */ 

public static final String NAME = " TA_UP_WAP " ; 

/** user-agent transmitted with every request coming from devices matching this profile 
*/ 

static final String USER_AGENT = "UP" ; 



/** 

* Retrieves the <code>Class</code> of the <cQde>Device</code> object that this profile 

creates . 

* ©return <code>Class</code> of the <code>UPWAPDevice</code> instances that this profilei^ 

generates . 

*/ 

public Class getDeviceClass ( ) { 

return new UPWAPDevice (this) .getClass (); 

} 



* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getName { ) { return NAME; } 



/** 

* Determines whether the actual device making a request is of the type represented by 

* <code>UPWAPDeviceProf ile</code> . 

* @param request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> ^ 

UPWAPDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFronnDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest ) req ; 
String userAgent = request . getHeader { "User-Agent ") ; 

return ( (userAgent != null ) && (userAgent . indexOf (USER_AGENT) >= 0)); 

) 

return false; 

} 
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/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* @param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest ) req; 
UPWAPDevice device = new UPWAPDevice (this) ; 

// declare temp values for device properties, to check for null 
String terapGUID, 

terapUserAgent , 

tempLanguage , 

tempFax, 

tempCharset, 

tempHost , 

tempSmartDialing, 

tempScreenDepth, 

tempColor, 

tempAlert , 

tempPDU, 

tempSof tKeys , 

tempScreenChars , 

tempPixels ; 



// initialize temps 

tempGUID = request . getHeader ( "x-up- subno" ) ; 
tempUserAgent = request .getHeader ( "User- Agent ") ; 
tempLanguage = request .getHeader ( "Accept -Language ") ; 
tempFax = request .getHeader ( "x-upf ax-accepts" ) ; 
tempCharset = request .getHeader ( "accept-charset ") ; 
tempHost = request .getHeader ( "Host" ) ; 

tempSmartDialing = request .getHeader ( "x-up-devcap-smartdialing" ) ; 
tempScreenDepth = request .getHeader ( "x-up-devcap- screendepth" ) ; 
tempAlert = request .getHeader { "x-up-devcap-immed-alert" ) ; 
tempColor = request .getHeader ( "x-up-devcap-iscolor" ) ; 
tempPDU = request .getHeader ( "x-up-devcap-max-pdu" ) ; 
tempSof tKeys = request . getHeader ( "x-up-devcap-numsof tkeys" ) ; 
tempScreenChars = request .getHeader ( "x-up-devcap-screenchars" ) ; 
tempPixels = request . getHeader ( "x-up-devcap- screenpixels ") ; 



// **NEED TO VERIFY IF THIS IS ALWAYS UNIQUE** - gordogre 10/18/2000 

if (tempGUID != null) device . setGUID ( UPWAPDeviceProf ile .NAME + ":" + tempGUID ) ; 

// COOKIES 

device . setCookies (request .getCookies ( ) ) ; 
// ACCEPT 

device . setAccept (request .getHeader ( "Accept " ) ) ,- 
// USER- AGENT 

device . setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// ACCEPT -LANGUAGE 

device . language = (tempLanguage == null) ? STRING_NO_VALUE : tempLanguage; 
// ACCEPT -FAX 

device. acceptFax = (tempFax == null) ? STRING_NO_VALUE : tempFax; 
// ACCEPT-CHARSET 
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device. acceptCharset = (tempCharset == null) ? STRING_NO_VALUE : tempCharset ; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 

// SMART DIALING 

if (tempSmartDialing != null) 

device . smartDialing = tempSmartDialing . equals ("1") ? true : false; 

// SCREEN DEPTH 

if (tempScreenDepth != null) 

( 

try 

{ 

device . screenDepth = Integer .parseint (tempScreenDepth) ; 

} 

catch (Exception e) 
{ 

device . screenDepth = INT_NO_VALUE ; 

} 

) 

else 
{ 

device. screenDepth = INT_NO_VALUE ; 

} 



// IS COLOR 

if (tempColor != null) 

device. isColor = tempColor . equals ("1") ? true : false; 

// IMMEDIATE ALERT 

if (tempAlert 1= null) 

device. immediateAlert = tempAlert . equals ("1") ? true : false; 

// MAX PDU 

device. maxPDU = (tempPDU == null) ? STRING_NO_VALUE : tempPDU; 

// NUMBER OF SOFT KEYS 
if (tempSof tKeys 1= null) 
{ 

try 

{ 

device . sof tKeys = Integer .parseint (tempSof tKeys) ; 

} 

catch (Exception e) 
{ 

device . sof tKeys = INT NO_VALUE; 

} 

} 

else 
{ 

device . sof tKeys = lNT_NO_VALUE ; 

} 

// SCREEN CHARACTERS 

device . screenChars = (tempScreenChars == null) ? STRING_NO_VALUE : tempScreenChars ; 

// SCREEN PIXELS 
if (tempPixels != null) 
{ 

try 

{ 

device .pixelWidth = Integer . parseint (tempPixels . substring (0, tempPixels i^r 
.indexOf (","))); 

device .pixelHeight = Integer .parseint (tempPixels . substring (tempPixels. 
indexOf ( " , " ) + 1) ) ; 
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} 

catch (Exception e) 
{ 

// This shouldn't kill everything, so we'll quietly catch it 
device. pixelHeight = INT_NO_VALUE ; 
device. pixelWidth = INT_NO_VALUE ; 

} 

} 

else 
{ 

device. pixelHeight = INT_NO_VALUE ; 
device .pixelWidth = INT_NO_VALUE; 

} 



return device; 

} 



/** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate ^ 

NO_VALUE constant. 

* @param guid unique device ID - may be null 

* @return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice {String guid) { 

UPWAPDevice device = new UPWAPDevice (this) ; 

device . setGUID ( guid ) ; 

// inintialize properties to NO_VALUE 
device . setUserAgent ( STRING_NO_VALUE ) ; 
device. language = STRING_NO_VALUE; 
device. acceptFax = STRING_NO_VALUE ; 
device. acceptCharset = STRING_NO_VALUE ; 
device. host = STRING_NO_VALUE ; 
device . screenDepth = INT_NO_VALUE ; 
device. maxPDU = STRING_NO_VALUE; 
device . softKeys = INT_NO_VALUE ; 
device. screenChars = STRING_NO_VALUE ; 
device. pixelWidth = INT_NO_VALUE ; 
device . pixelHe ight = INT_NO_VALXJE ; 

return device; 

} 



} // end 



/* 

Content -Type : application/x-www- f orm-urlencoded 
Accept-Charset: ISO-8859-1, UTF-8, * 
x-up-subno: prof ix_LT-CT- 622 0 
x-upf ax-accepts : none 
x-up-devcap-charset : ISO-8859-1 

Accept: application/x-hdmlc , application/x-up-alert , application/x-up-cacheop, application/ 

x-up-device, application/x-up-digestentry, application/vnd . wap . wml , text/x-wap . wml , text/ 
vnd.wap.wml, application/vnd. wap. wml script, text/vnd . wap . wmlscript , application/vnd. ^ 
uplanet . channel , application/vnd.uplanet .list, text/x-hdml, text/plain, text/html, image/ 
vnd . wap . wbmp , image/bmp, application/remote-printing text/x-hdml ; version=3 . 1 , text/x-hdml kT 
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*/ 
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* @ C#) UPWAPDevice . java 
*/ 

package com . thinairapps .platform. device ; 

import javax. servlet . * ; 
import javax. servlet .http. *; 

/** 

* ThinAirApps ' s abstraction for up.com WAP phones 
*/ 

public class UPWAPDevice extends WAPDevice { 

// serialVersionUID for compatability with previous versioni 
static final long serialVersionUID = -9047029144031715525L; 

protected boolean smartDialing ; 
protected boolean isColor; 
protected boolean immediateAlert ; 
protected int softKeys; 
protected int screenDepth; 
protected int pixelWidth; 
protected int pixelHeight; 
protected String language; 
protected String maxPDU; 
protected String screenChars ; 
protected String host; 
protected String acceptFax; 
protected String acceptCharset ; 



* Constructs a new <code>UPWAPDevice</code> instance of the type represented by profile. 

* Sparam profile <code>UPWAPDeviceProf ile</code> prototype for this device instance 
*/ 

UPWAPDevice (UPWAPDeviceProf ile profile) { 
super (profile) ; 

} 

/** 

* Retrieves a value indicating whehter the device accepts UP faxes. 

* <p> 

* Value is typically "1" if device does accept faxes, "0" if it does not. 

* ©return <code>String</Gode> accepts UP-Fax 
*/ 

public String getAcceptFax ( ) { retura acceptFax; } 



* Retrieves the character encoding set supported by the device. 

* @return <code>String</code> character set supported by device */ 
public String getAcceptCharset ( ) { return acceptCharset; } 

/** 

* Retrieves the language locale supported by the device. 

* ©return <code>String</code> language locale, if specified 
*/ 

public String getLanguage ( ) { return language; } 
/** 

* Retreives flag indicating if smart dialing is enabled on this device. 

* ©return < code >boolean</c ode > true if smart dialing enabled, false otheri 
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public boolean isSmartDialing ( ) { return smartDialing ; } 
/** 

* Retrieves the screen depth of this device. 

* ©return <code>int</code> screen bit depth 
*/ 

public int getScreenDepth ( ) { return screenDepth; } 

* Retreives flag indicating whether this is a color device. 

* @return <code>boolean</code> true if device is color, false otherwise 
*/ 

public boolean isColorO { return isColor; } 
/** 

* Retreives flag indicating if immediate alert is enabled on this device. 

* ©return <code>boolean</code> true if immediate alert enabled, false otherwise 
*/ 

public boolean immediateAlert ( ) { return immediateAlert ; } 
/** 

* Retrieves the maximum size of PDU's this device supports. 

* ©return <code>String</code> max PDU 
*/ 

public String getMaxPDUO { return maxPDU; } 
/** 

* Retrieves the number of soft keys on this device. 

* ©return <code>int</code> number of soft keys 
*/ 

public int numSof tKeys () { return softKeys; } 
/** 

* Retrieves the dimension of the devices screen in terms of characters. 

* The format for this value is-. "H,V", where H is horizontal characters (rows) and V is 

vertical characters (columns) . 

* ©return <code>String</code> screen characters 
*/ 

public String getScreenChars ( ) { return screenChars ; } 
/** 

* Retreives the width of the device's screen in pixels. 

* @return <code>int</code> screen pixel width 
*/ 

public int getPixelWidth ( ) { return pixelWidth; } 
/** 

* Retrieves the height of the device's screen in pixels. 

* Oreturn <code>int</code> screen pixel height 
*/ 

public int getPixelHeight ( ) { return pixelHeight ; } 



} // end 
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/** 

* @ (#) TellMeDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device ; 

import j avax . servlet . * ; 
import j avax. servlet -http. * ; 

/** 

* implements ThinAirApps • s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for HDML devices 

*/ 

public class TellMeDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
Static final long serialVersionUID = 2489998979065444352L; 

/** name of this device profile */ 

public static final String NAME = "TA_TELLME" ; 

/** content type accepted by all devices matching this profile */ 
protected static final String CONTENT_TYPE = "text/xml"; 



* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile \^ 

* ©return < code >Class< /code > of the <code>TellMeDevice</code> instances that this w? 

profile generates. 

*/ 

public Class getDeviceClass { ) { 

return new TellMeDevice (this) .getClass () ; 

} 



* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this ■ 

DeviceProf ile</code> 

*/ 

public String getName ( ) { return NAME; } 



* Determines whether the actual device making a request is of the type represented by 

* <code>TellMeDeviceProf ile</code> . 

* (Sparam request the actual <code>ServletRequest</code> received by the ThinAir Server 

* (Sreturn < code >boolean</ code > true if the requesting device is of type <code> 

TellMeDevice</code>, false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent headf 
HttpServletRequest request = (HttpServletRequest) req; 
String userAgent = request .getHeader ( "User-Agent ") ; 

return ( (userAgent != null ) && 

(userAgent . equals ( "Tellme/l . 0 (I; en-US)") || userAgent . equals 
("libwww-perl/5.47") ) ); 



return false; 

} 
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* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* ©param req the actual <code>ServletReguest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the ^ 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest) req; 
TellMeDevice device = new TellMeDevice (this) ; 

// no known value to use for GUID, so do not set 

// USER-AGENT 

String tempUserAgent = request .getHeader ( "User-Agent ") ; 

device . setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// COOKIES 

device . setCookies ( request . getCookies () ) ; 
// ACCEPT 

device . setAccept (request .getHeader ( "Accept") ) ; 
return device; 



/** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant. 

* ©param guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

TellMeDevice device = new TellMeDevice (this) ; 

// TellMeDevice device does not have GUID, so do not set 

// inintialize properties to NO_VALUE 
device . setUserAgent (STRING_NO_VALUE) ; 

return device; 

} 



} // end 
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/** 

* @(#)TellMeDevice. java 
*/ 

package com. thinairapps .platform, device ,- 

import javax. servlet . * ; 
import javax. servlet .http. * ; 

/** 

* ThinAirApps ' s abstraction for the TellMe browser 
*/ 

public class TellMeDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -3692689441219031923L; 

/** 

* Constructs a new <code>TellMeDevice</code> instance of the type represented by profilenf 

* ®param profile <code>TellMeDeviceProf ile</code> prototype for this device instance 
*/ 

TellMeDevice (TellMeDeviceProf ile profile) { 
super (prof ile) ; 

} 

/** 

* Retrieves the content encoding type supported by this device. 

* ©return <code>String</code> content type supported by this device. 
*/ 

public String getContentType () { 

return TellMeDeviceProf ile . CONTENT_TYPE ; 

} 

} // end 
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/** 

* @ {#) PocketlEDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device ; 

import javax. servlet . * ; 
import javax. servlet .http. * ; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> ^ 

factory for Pocket IE devices 

*/ 

public class PocketlEDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 4004923160351708628L; 

/** name of this device profile */ 

public Static final String NAME = "TA_POCKETIE" ; 

/** content type accepted by all devices matching this profile */ 
public static final String CONTENT_TYPE = "text/html"; 

/** user agent transmitted with every request from this device */ 
;=;; public Static final String USER_AGENT = "Mozilla/2.0 (compatible; MSIE 3.02; Windows 
CE) " ; 



* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile i*f 

creates . 

* ©return <code>Class</code> of the <code>PocketIEDevice</code> instances that this 

profile generates. 

*/ 

public Class getDeviceClass ( ) { 

return new PocketlEDevice (this) .getClass () ; 

} 



/** 

* Retrieves the friendly name of this device type description. 

* @return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getName () { return NAME; } 



* Determines whether the actual • device making a request is of the type represented by 

* <code>PocketIEDeviceProf ile</ code> . 

* @param request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> ^ 

PocketlEDevice</code>, false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest ) req ; 
String userAgent = request . getHeader ( "User- Agent ") ; 

return ( (userAgent != null ) && (userAgent . indexOf ( "Windows CE") >= 0)}; 

} 

return false; 



C: \TASS\ ■ ■ \thinairapps\platf orm\device\PocketIEDeviceProf ile . java 



2 



* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

= (HttpServletRequest) req; 
' Pocket I EDevice (this) ; 

// no known value to use for GUID, so do not set 

// declare temp values for device properties, to check for null 
String tempUserAgent , 
tempHost , 
tempos , 
tempColor , 
tempScreenPixels ; 

// initialize temps 

tempUserAgent = request .getHeader ( "User- Agent ") ; 
tempHost = request . getHeader { "Host ") ; 
tempos = request .getHeader { "UA-OS" ) ; 
tempColor = request .getHeader ( "UA-color" ) ; 
tempScreenPixels = request .getHeader ( "UA-pixels ") ; 

// COOKIES 

device . setCookies (request .getCookies ( ) ) ; 
// ACCEPT 

device . setAccept (request .getHeader ( "Accept " ) ) ; 
// USER- AGENT 

device . setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// HOST 

device. m_host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 
// OS 

device. m_os = (tempOS == null) ? STRING_NO_VALUE : tempOS; 
// COLOR 

device. m_color = (tempColor == null) ? STRING_NO_VALUE : tempColor; 
// SCREEN PIXELS 

device .m_screen = {tempScreenPixels == null) ? STRING_NO_VAl,UE : tempScreenPixels; 
return device ; 



/** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure ■ 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant . 
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* @param guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

PocketlEDevice device = new PocketlEDevice (this) ; 

// PocketlE device does not have GUID, so do not set 

// inintialize properties to NO_VALUE 
device . setUserAgent ( STRING_NO_VALUE) ; 
device. m_host = STRING_NO_VALUE ; 
device. m_os = STRING_NO_VALUE ; 
device . m_color = STRING_NO_VALUE; 
device . m_screen = STRING_NO_VALUE ; 

return device ,- 



} // end 
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* @(#)PocketIEDevice. java 
*/ 

package com . thinairapps . platform . device ; 

import j avax . servlet . * ; 
import j avax. servlet -http. *; 

/** 

* ThinAirApps abstraction for devices supporting Microsoft Pocket IE 
*/ 

public class PocketlEDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -3014994380237056646L; 

protected String m_os, m_color, m_screen, m_host ; 



* Constructs a new <code>PocketIEDevice</code> instance of the type represented by- 

profile . 

* @param profile <code>PocketIEDeviceProf ile</code> prototype fox this device instance 
*/ 

PocketlEDevice (PocketlEDeviceProf ile profile) { 
super (profile) ; 

} 

/** 

* Retrieves the content encoding type supported by this device. 

* (Sreturn <code>String</code> content type supported by this device. 
*/ 

public String getContentType () { return PocketlEDeviceProf ile . CONTENT_TYPE ; } 
/** 

* Retrieves a description of the operating system running on the device. 

* ©return <code>String</code> OS of this device */ 
public String getOSO { return m_os ; ) 

/** 

* Retrieves the color depth of the screen for the device. 

* ©return ccode>String</code> color depth of device 
*/ 

public String getColorDepth { ) { return m_color; } 
/** 

* Retrieves the screen size of the device. 

* <p> 

* The returned value will be in the format "HxW" , where H is the height of the screen 

* in pixels, and W is the width of the screen in pixels. 

* ©return <code>String</code> screen size of the device. 
*/ 

public String getScreenSize ( ) { return m_screen; } 
/** 

* Retrieves the address of the host targeted by the request. 

* ©return <code>String</code> host targeted by request 
*/ 

public String getHost { ) { return m_host; } 
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* ©{#) PalmVIIDeviceProf ile . java 
*/ 

package com . thinairapps . platform . device ; 

import javax. servlet . * ; 
import javax. servlet .http. * ; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for Palm VII devices 

*/ 

public class PalmVI IDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 6054987558599139231L; 

/** name of this device profile */ 

public static final String NAME = " TA_PALM_VII " ; 

/** user-agent transmitted with every request coming from devices matching this profile 
*/ 

// public static final String USER_AGENT = "Mozilla/2.0 {compatible; Elaine/1.0)"; 

/** content type accepted by all devices matching this profile */ 
public static final String CONTENT_TYPE = "text/html"; 

// seems like Elaine sends user-agent as a lower case string 
private static final String userAgentKey = "user-agent"; 



/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

creates . 

* ©return <code>Class</code> of the <code>PalraVIIDevicec/code> instances that this 

profile generates. 

*/ 

public Class getDeviceClass ( ) { 

return new PalmVIIDevice (this) .getClass (); 

} 



/** 

* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getNaraeO { return NAME; } 



/** 

* Determines whether the actual device making a request is of the type represented by 

* <code>PalmVIIDeviceProf ile</code> . 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

PalmVIIDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if ( super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest) req; 

String userAgent = request .getHeader ( "User-Agent ") ; 
// sgross 12/12/2000: 
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// This change ensures that Elaine servers which are ABOVE : 
// will not be recognized by this profile 
// Reports are that the content - encodings for Elaine/2. 
// be incompatible with our software 
return ( (userAgent != null ) && (userAgent . indexOf ( "Elaine/1" ) 



return false; 



/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* @param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the ^ 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest) req; 
PalmVIIDevice device = new PalmVIIDevice (this) ; 



// this may not be present if not originating from our Palm Secure Client - gordogre 
String guid = request .getParameter ("d"); 
if (guid == null) 

guid = request .getParameter ("did"); 
if (guid == null) 

guid = request .getParameter ( "deviceid" ) ; 

// if we do not find a suitable guid, we should not set device GUID - gordogre 
if (guid != null) device . setGUID (NAME + ":" + guid); 

// declare temp values for device properties, to check for null 
String tempUserAgent , 

tempHost , 

tempVia, 

tempConnection, 

tempForwardedFor , 

tempEl aineVers ion ; 

// initialize temps 

tempUserAgent = request .getHeader ( "User- Agent " ) ; 
tempHost = request .getHeader ( "Host ") ; 
tempVia = request . getHeader ( "Via" ) ; 
tempConnection = request .getHeader ( "Connection" ) ; 
tempForwardedFor = request .getHeader ( "X-Forwarded-For" ) ; 
tempElaineVersion = parseElaineVersion (tempUserAgent) ; 



// COOKIES 

device. setCookies (request .getCookies ()); 
// ACCEPT 

device. setAccept (request .getHeader ( "Accept " ) ) ; 

// USER- AGENT 

device. setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// VIA 

device. via = (tempVia == null) ? STRING_NO_VALUE : tempVia; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 
// CONNECTION 
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device. connectionType = (tempConnection == null) ? STRING_NO_VALUE : tempConnection; 
// FORWARDED -FOR 

device. forwardAddress = ( tempForwardedFor == null) ? STRING_NO_VALUE : i^' 
tempForwardedFor ; 

// ELAINE VERSION 

device. elaineVersion = (tempElaineVersion == null) ? STRING_NO_VALUE : \^ 
t empElaineVers ion ; 



/** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate ^ 

NO_VALUE constant . 

* @param guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

PalraVIIDevice device = new PalmVIIDevice (this) ; 
device. setGUID{ guid ) 

// initialize properties to NO_VALUE 

device. setUserAgent (STRING_NO_VALUE) ; 

device. via = STRING_NO_VALUE ; 

device. host = STRING_NO_VALUE ; 

device. connectionType = STRING_NO_VALUE; 

device. forwardAddress = STRING_NO_VALUE; 

device. elaineVersion = STRING_NO_VALUE ; 

return device; 

} 



/** 

* Parses User-Agent header to retrieve version of Elaine browser 

* Oparam <code>String</code> User-Agent header from request 

* ©return <code>String</code> Elaine version making request, or null if the Elaine ^ 

version cannot be obtained 

*/ 

private String parseElaineVersion (String ua) 
{ 

String temp; 
int index; 

// first checlt for null string 

if (ua null) 

{ 

return null; 

} 

else 
{ 

// obtain index of string preceding version number; i.e. "Mozilla/2.0 (compatible 

; Elaine/1.0) " 
index = ua . indexOf ( "Elaine/ ") ; 
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// now obtain substring begining with versio number 
temp = ua . substring ( index + 7) ; 

// obtain ending index of version number 
index = temp . indexOf (")">; 

if (index > 0) 

{ // return substring containing version number only 
return temp . substring ( 0 , index) ; 



// if version number not present, return null 
return null ; 




} // end 
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/** 

* @ (#) PalmVIIDevice. java 
*/ 

package com. thinairapps . platform. device ; 

import javax. servlet . * ; 
import javax. servlet .http .* ; 

* ThinAirApps ' s abstraction for the Palm VII PDA 
*/ 

public class PalmVIIDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 4619797748056875641L; 

protected String f orwardAddress , host, via, connectionType , elaineVersion; 
/** 

* Constructs a new <code>PalmVIIDevice</code> instance of the type represented by 

profile . 

* ©pararn profile <code>PalmVIIDeviceProf ile</code> prototype for this device instance 
*/ 

PalmVIIDevice (PalmVIIDeviceProf lie profile) { 
super (profile) ; 

} 

* Retrieves the content encoding type supported by this device. 

* ©return <code>String</code> content type supported by this device. 
*/ 

public String getContentType ( ) { 

return PalmVIIDeviceProf ile . CONTENT_TYPE ,- 

} 

/** 

* Retrieves the connection type for the request. 

* <p> 

* Typical values are "Keep-Alive" or "Close". 

* ©return <code>String</code> connection type for the request 
public String getConnectionType () { return connectionType; } 
/** 

* Retrieves the IP address of the device. 

* This is not necessarily a unique client IP address! 

* ©return String IP address of device 
*/ 

public String getForwardAddress () { return f orwardAddress ; } 
/** 

* Retrieves the address of the host targeted by the request. 

* ©return <code>String</code> host targeted by request 
*/ 

public String getHostO { return host; } 
/** 

* Retrieves the domain of the device's gateway. 

* ©return <code>String</code> domain of request origin (gateway domain) 
*/ 

public String getGatewayO { return via; } 
/** 

* Retrieves the version of the Elaine browser running on the device. 
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* ©return <code>String</code> version of Elaine browser making request 
public String getElaineVersion ( ) { return elaineVersion; } 
} // end 
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* @ (#) OmniSkyDeviceProf ile . java 
*/ 

package com. thinairapps .plat form. device; 

import javax. servlet . * ; 
import javax. servlet .http. * ; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for OtnniSky devices 

*/ 

public class OmniSkyDeviceProf ile extends HTTPDeviceProf ile { 



// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 7531455097521934005L; 



/** name of this device profile */ 

public static final String NAME = "TA_OMNISKY" ; 

/** user-agent transmitted with every request coming from devices matching this profile 
*/ 

static final String CONTENT_TYPE = "text/html"; 

/** content type accepted by all devices matching this profile */ 
static final String USER_AGENT = "Mozilla/2.0 (compatible; Elaine/1.0)"; 

/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

creates . 

* ©return <code>Class</code> of the <code>OmniSkyDevice</code> instances that this 

profile generates. 

*/ 

public Class getDeviceClass ( ) { return new OmniSkyDevice (this) .getClass ( ) ; } 



* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getName ( ) { return NAME; } 



/** 

* Determines whether the actual device making a request is of the type represented by 

* <code>OmniSkyDeviceProf ile</code> . 

* @param request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

OmniSkyDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if { super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest } req; 
String userAgent = request .getHeader ( "User- Agent" ) ; 

// must also check "via" header, which will contain "OMMD" for OmniSky gateways 
String terapVia = request . getHeader ( "Via" ) ; 

return ( (userAgent != null ) && 
(tempVia != null) && 

(userAgent . indexOf ( "Elaine" ) >= 0) && 
(tempVia.indexOf ("OMMD") >= 0) ); 
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} 



/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the \/ 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest) req; 
OmniSkyDevice device = new OmniSkyDevice (this) ; 

// this may not be present if not originating from our Palm Secure Client - gordogre 
String guid = request .getParameter ("d"); 
if (guid == null) 

guid = request .getParameter ("did"); 
if (guid == null) 

guid = request .getParameter ( "deviceid" ) ; 

// if we do not find a suitable guid, we should not set device GUID - gordogre 
if (guid != null) device . setGUID (NAME + ":" + guid) ; 



// declare temp values for device properties, to check for null 
String tempUserAgent , 

tempHost , 

tempvia, 

tempElaine Vers ion; 
// initialize temps 

tempUserAgent = request . getHeader ("User-Agent"); 
tempHost = request .getHeader ( "Host ") ; 
tempVia = request .getHeader ( "Via" ) ; 

tempElaineVersion = parseElaineVersion (tempUserAgent) ; 
// COOKIES 

device . setCookies (request .getCookies {)); 
// ACCEPT 

device . set Accept (request .getHeader ( "Accept " ) ) ; 
// USER- AGENT 

device. setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// VIA 

device. via = (tempVia == null) ? STRING_NO_VALUE : tempVia; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 

// ELAINE VERSION 

device .elaineVersion = (tempElaineVersion == null) ? STRING_NO_VALUE : \^ 
tempElaineVersion; 



return device; 



* Create a <code>Device</code> from a <code>String</code> device GUID 
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* This method is used primarily by administrators to preconfigure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate <^ 

NO_VALUE constant. 

* (Sparam guid unique device ID - may be null 

* @return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice {String guid) { 

OmniSkyDevice device = new OmniSkyDevice (this) ; 

device. setGUID ( guid ) ; 

// initialize properties to NO_VALUE 
device. setUserAgent (STRING_NO_VALUE) ; 

device, via = STRING_NO_VAL,UE ; 
device. host = STRING_NO_VALUE ; 
device. elaineVersion = STRING_NO_VALUE ; 

return device; 

} 



* Parses User-Agent header to retrieve version of Elaine browser 

* @param <code>String</code> User-Agent header from request 

* ©return <code>String</code> Elaine version making request, or null if the Elaine ^ 

version cannot be obtained 

*/ 

private String parseElaineVersion (String ua) 
{ 

String temp; 

// first check for null string 

if (ua == null) 

{ 

return null; 

} 

else 

// obtain index of string preceding version number; i.e. "Mozilla/2.0 (compatiblevir 

; Elaine/1.0) " 
index = ua . indexOf ( "Elaine/ ") ; 

// now obtain substring begining with versio number 
temp = ua . substring ( index + 7) ; 

// obtain ending index of version number 
index = temp . indexOf (")"); 

if (index > 0) 

{ // return substring containing version number only 
return temp . substring ( 0 , index) ; 

\se 

{ // if version number not present, return null 
return null ; 

} 




} // end 
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/** 

* @ (#) OmniSkyDevice . java 
*/ 

package com. thinairapps .platform. device ; 

import javax. servlet . * ; 
import javax. servlet .http. * ; 

* ThinAirApps ' s abstraction for Omni Sky- enabled devices 
*/ 

public class OmniSkyDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -8857853771839964701L,- 

protected String host, via, elaineVersion; 

/** 

* Constructs a new <code>OmniSkyDevice</code> instance of the type represented by 

* (Sparam profile <code>OmniSkyDeviceProf ile</cGde> prototype for this device instance 
*/ 

OmniSkyDevice (OmniSkyDeviceProf ile profile) { 
super (profile) ; 

} 

/** 

* Retrieves the content encoding type supported by this device. 

* ©return <code>String</code> content type supported by this device. 
*/ 

public String getContentType () { 

return OmniSkyDeviceProf ile . CONTENT_TYPE ; 

} 

/** 

* Retrieves the address of the host targeted by the request. 

* ©return <code>String</code> host targeted by request 
*/ 

public String getHostO { return host; } 
/** 

* Retrieves the domain of the device's gateway. 

* ©return <code>String</code> domain of request origin {gateway domain) 
*/ 

public String getGatewayO { return via,- } 
/** 

* Retrieves the version of the Elaine browser running on the device. 

* ©return <code>String</code> version of Elaine browser making request 
*/ 

public String getElaineVersion ( ) { return elaineVersion; } 
} // end 
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* @ (#) NokiaWAPDeviceProf ile . java 
*/ 

package com. thinairapps .platform . device ; 

import j avax . servlet . * ; 
import j avax. servlet. http.*; 

/**implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 
factory for NOKIA WAP phones 

V 

public class NokiaWAPDeviceProf ile extends WAPDeviceProf ile { 



// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -7297723379847931620L; 



/** name of this device profile */ 

public static final String NAME = " TA_NOKI A_WAP " ; 
// FIXME FIXME FIXME : set the proper user agent 

/** user-agent transmitted with every request coming from devices^matching this profile 
*/ 

static final String USER_AGENT = "nokia-user-agent" ; 



/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

creates . 

* ©return <code>Class</code> of the <code>NokiaWAPDevice</code> instances that this 

profile generates. 

*/ 

public Class getDeviceClass ( ) { 

return new NokiaWAPDevice (this) .getClass ( ) ; 

} 



/** 

* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getNameO { return NAME; } 
/** 

* Determines whether the actual device making a request is of the type represented by 

* <code>NokiaWAPDeviceProf ile</code> . 

* @param request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

NokiaWAPDevice</code>, false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest) req; 
String userAgent = request .getHeader ( "User-Agent" ) ; 

return ( (userAgent != null ) && (userAgent . indexOf ( "Nokia" ) >= 0)); 

} 

return false; 
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/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletReguest req) { 

HttpServletRequest request = (HttpServletRequest ) req ; 
NokiaWAPDevice device = new NokiaWAPDevice (this) ; 

// cannot verify that x-network-inf o will be unique, so do 
// not set QUID - gordogre 

// declare temp values for device properties, to check for null 
String tempUserAgent , 

t empE nc od i ng , 

tempHost, 

tempVia, 

tempLanguage, 

tempCharset, 

tempNetworkInf o; 

// initialize temps 

tempUserAgent = request .getHeader ( "User- Agent ") ; 
tempEncoding = request . getHeader ( "Accept -Encoding" ) ; 
tempHost = request. getHeader ( "Host" ) ; 
tempVia = request .getHeader ("Via") ; 

tempLanguage = request . getHeader ( "Accept-Language" ) ; 
tempCharset = request .getHeader ( "Accept -Charset ") ; 
tempNetworkInf o = request .getHeader ( "x-network-inf o" ) ; 



// COOKIES 

device . setCookies (request . getCookies ()); 
// ACCEPT 

device . setAccept (request .getHeader { "Accept" ) ) ; 
// USER-AGENT 

device. setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// ACCEPT-LANGUAGE 

device . acceptLanguage = (tempLanguage == null) ? STRING_NO_VALUE : tempLanguage ; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 
// ACCEPT- ENCODING 

device . acceptEncoding = (tempEncoding == null) ? STRING_NO_VALUE : tempEncoding; 
// VIA 

device. via = (tempVia == null) ? STRING_NO_VALUE : tempVia; 
// ACCEPT- CHARSET 

device. acceptCharset = (tempCharset == null) ? STRING_NO_VALUE : tempCharset; 
// NETWORK- INFO 

device .networklnfo = { tempNetworkInf o == null) ? STRING_NO_VALUE : tempNetworkInf o ; 



return device; 

} 
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* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant . 

* ©param guid unique device ID - may be null 

* Oreturn a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

NokiaWAPDevice device = new NokiaWAPDevice ( this ) ; 

// NokiaWAPDevices have no GUID, so do not set 

// initialize properties to NO_VALUE 
device . setUserAgent ( STRING_NO_VALUE) ; 
device. accept Language = STRING_NO_VALUE ; 
device. host = STRING_NO_VALUE ; 
device . acceptEncoding = STRING_NO_VALUE ; 
device. via = STRING_NO_VALUE ; 
^'f device. acceptCharset = STRING_N0_VALUE; 

device.networklnfo = STRING_NO_VALUE ; 

return device; 



} // end 



C : \TASS\ ■ ■ \thinairapps\plat f on:n\device\NokiaWAPDevice . j ava 

/** 

* @(#)NokiaWAPDevice. java 
*/ 

package com . thinairapps . platform . device ; 

import j avax . servlet . * ; 
import j avax. servlet . http. * ,- 

/** 

* ThinAirApps ' abstraction for the Nokia family of WAP phones 
*/ 

public class NokiaWAPDevice extends WAPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 3955919879913874076L; 

protected String host, acceptLanguage , via, acceptEncoding, 
acceptCharset, networklnfo; 

/** 

* Constructs a new <code>NokiaWAPDevice</code> instance of the type represented by 

* Oparam profile <code>NokiaWAPDeviceProf ile</code> prototype for this device instance 
*/ 

: -■ NokiaWAPDevice (NokiaWAPDeviceProf ile profile) { 
super (profile) ; 



* Retrieves the address of the host targeted by the request. 

* @return <code>String</code> host targeted by request 
*/ 

public String getHostO { return host; } 
/** 

* Retrieves the language locale supported by the device. 

* ©return <code>String</code> language locale, if specified 
*/ 

public String getAcceptLanguage (} { return acceptLanguage; } 
/** 

* Retrieves the domain of the device's gateway. 

* ©return <code>String</code> domain of request origin (gateway domain) 
*/ 

public String getGatewayO { return via; } 
/** 

* Retrieves a comma delimited list of file encodings supported by the device. 

* ©return <code>String</code> list of file encodings acceptable by the device. 
*/ 

public String getAcceptEncoding () { return acceptEncoding; } 

* Retrieves the list of Character Set encodings supported by the device. 



* ©return <code>String</code> character set(s) supported by this device. 
*/ 

public String getAcceptCharset ( ) { return acceptCharset; } 
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* Retrieves information describing device's netwo 

* <p> 

* Typical format: {data transport type} , {client IP address}, {s 

* ©return <code>String</code> device's network information 
*/ 

public String getNetworkInf o O { return networklnfo; } 



C: \TASS\ ■ . \thinairapps\platf orm\device\HTMLDeviceProf ile . java 



1 



/** 

* @(#)HTMLDeviceProf ile. java 
*/ 

package com . thinairapps . platform. device ; 

import javax. servlet . * ; 
import javax. servlet -http .* ; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for HTML devices 

*/ 

public class HTMLDeviceProf ile extends HTTPDeviceProf ile { 



// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -8489332563057202787L; 



/** name of this device profile */ 

public static final String NAME = "TA_HTML" ; 

/** content type accepted by all devices matching this profile */ 
protected static final String CONTENT_TYPE = "text/html"; 



/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

creates . 

* ©return <code>Class</code> of the <code>HTMLDevice</code> instances that this profile 

generates . 

*/ 

public Class getDeviceClass ( ) { 

return new HTMLDevice (this) .getClass (); 

} 



/** 

* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</ code> 

*/ 

public String getNameO { return NAME; } 



/** 

* Determines whether the actual device making a request is of the type represented by 

* <code>HTMljDeviceProf ile</code> . 

* Oparam request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

HTMLDevice</code>, false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if ( super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check User-Agent header 
HttpServletRequest request = (HttpServletRequest ) req; 
String accept = request .getHeader ( "Accept ") ; 
String userAgent - request . getHeader ( "User-Agent ") ; 

return ( ((userAgent != null) && (userAgent . indexOf ( "Mozilla" ) >= 0) || 
(accept != null ) && ( accept . indexOf (" text/html " ) >= 0)) ); 

} 

return false; 
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/** 

* Create a < code >Device</ code > instance with the same properties as the actual 

* physical device that generated this servlet request. 

* ©paraiti req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromReguest (ServletRequest req) { 



// no sure way of obtaining unique id, so do not set device. GUID 

// declare temp values for device properties, to check for null 
String tempUserAgent , 

tempEncoding , 

tempHost, 

tempConnection, 

tempLanguage ; 

// initialize temps 

tempUserAgent = request . getHeader ( "User- Agent " ) ; 
tempEncoding = request .getHeader { "Accept -Encoding ") ; 
tempHost = request .getHeader ( "Host" ) ; 
tempConnection = request .getHeader { "Connection" ) ; 
tempLanguage = request .getHeader ( "Accept -Language" ) ; 

// COOKIES 

device . setCookies (request .getCookies ()); 
// ACCEPT 

device . setAccept ( request . getHeader ( "Accept " ) ) ; 
// USER- AGENT 

device . setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// ACCEPT -LANGUAGE 

device . acceptLanguage = (tempLanguage == null) ? STRING_NO_VALUE : tempLanguage; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 
// ACCEPT- ENCODING 

device .acceptEncoding = (tempEncoding == null) ? STRING_NO_VALUE : tempEncoding; 
// CONNECTION TYPE 

device. connect ionType = (tempConnection == null) ? STRIN"G_NO_VALUE : tempConnection; 
return device; 



/** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 
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* ©param guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

HTMLDevice device = new HTMLDevice (this) ; 

// HTMLDevices have no GUID, so do not set 

// initialize properties to NO_VALUE 
device . setUserAgent {STRING_MO_VALUE ) ; 
device .acceptLanguage = STRING_N0_VALUE; 
device. host = STRING_NO_VALUE ; 
device . acceptEncoding = STRING_NO_VALUE; 
device, connect ionType = STRING_N'0_VALUE ; 

return device; 

} 



} // end 
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/** 

* @C#)HTMLDevice. java 
*/ 

package com. thinairapps .platform. device ; 

import j avax . servlet . * ; 
import j avax. servlet .http. * ; 

/** 

* ThinAirApps ' s abstraction for all HTML devices 
*/ 

public class HTMLDevice extends HTTPDevice ( 

// serialVersionUID for cottipatability with previous versions 
static final long serialVersionUID = -937006866328419345L; 

protected String acceptLanguage , acceptEncoding , connect ionType, host; 

/** 

* Constructs a new <code>HTMLDevice</code> instance of the type represented by profile. 

* @param profile <code>HTMLDeviceProf ile</Gode> prototype for this device instance 
*/ 

HTMLDevice (HTMLDeviceProf ile profile) { 
super (prof ile) ; 

} 

/** 

* Retrieves the content encoding type supported by this device. 

* ©return <code>String</code> content type supported by this device. 
*/ 

public String getContentType ( ) { 

return HTMLDeviceProf ile . CONTENT_TyPE ; 

} 

/** 

* Retrieves the language locale supported by the device. 

* ©return <code>String</code> language locale, if specified 
*/ 

public String getAcceptLanguage ( ) { return acceptLanguage; } 
/** 

* Retrieves a comma delimited list of file encodings supported by the device. 

* ©return <code>String</code> list of file encodings acceptable by the device. 
*/ 

public String getAcceptEncoding ( ) { return acceptEncoding; } 
/** 

* Retrieves the connection type for the request. 

* ©return <code>String</code> connection type for the request (typically "Keep-Alive" ori^ 

"Close" ) 

*/ 

public String getConnect ionType ( ) { return connectionType ; } 
/** 

* Retrieves the address of the host targeted by the request. 

* ©return <code>String</code> host targeted by request 
*/ 

public String getHostO { return host; } 



} // end 
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/** 

* @ (#) HDMLDeviceProf ile . java 
*/ 

package com. thinairapps .platform. device ; 

import javax. servlet . * ; 
import javax. servlet .http.* ; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> ^ 

factory for HDML devices 

*/ 

public class HDMLDeviceProf ile extends HTTPDeviceProf ile { 



// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -14271900610239067481.; 



/** name of this device profile */ 

public static final String NAME = "TA_HDML"; 

/** the content type expected by this device */ 
Static final String CONTENT_TYPE = "text/x-hdml " ; 

/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile kT 

creates . 

* ©return <code>Class</code> of the < code >HDMLDevice</ code > instances that this profile ^ 

generates . 

*/ 

public Class getDeviceClass ( ) { 

return new HDMLDevice (this) .getClass (); 

} 



* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> it 

DeviceProf ile</code> 

*/ 

public String getName ( ) { return NAME; } 



* Determines whether the actual device making a request is of the type represented by 

* <code>HDMLDeviceProf ile</code> . 

* Oparam request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

HDMLDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req)) { 

// now cast request to HttpServletRequest to retrieve and check Accept header 
HttpServletRequest request = (HttpServletRequest ) req; 
String accept = (String ) request . getHeader ("Accept"); 

return ( (accept != null ) && (accept . indexOf (CONTENT_TYPE) >= 0)); 

} 

return false; 

} 
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* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* @param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletReguest request = (HttpServletRequest) req,- 
HDMLDevice device = new HDMLDevice (this) ; 

// declare temp values for device properties, to check for null 
String tempGUID, 

tempUserAgent ; 

// initialize temps 

tempGUID = request .getHeader( "x-up-subno") ; 
tempUserAgent = request . getHeader ("User-Agent"); 

// **NEED TO VERIFY IF THIS IS ALWAYS UNIQUE** - gordogre 10/i8/2000 

if (tempGUID 1= null) device . setGUID ( HDMLDeviceProf ile. NAME + ":" + tempGUID ); 
// COOKIES 

device . setCookies (request .getCookies ( ) ) ; 
// ACCEPT 

device . setAccept ( request . getHeader ( "Accept " ) ) ; 
// USER- AGENT 

device. setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
return device; 



/** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 



* ©parara guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
public Device createDevice (String guid) { 

HDMLDevice device = new HDMLDevice (this) ; 

device. setGUID ( guid ); 

// initialize properties to NO_VALUE 
device . setUserAgent ( STRING_NO_VALUE) ; 



eturn device; 



} // end 
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/** 

* @(#)HDMLDevice. java 
*/ 

package com . thinairapps . platform . device ; 

import javax. servlet . * ; 
import javax. servlet. http.*; 

/** 

* ThinAirApps ' s abstraction for all HDML devices 
*/ 

public class HDMLDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 5976014305772814S80L; 

/** 

* Constructs a new <code>HDMLDevice</code> instance of the type represented by profile. 

* @param profile <code>HDMLDeviceProf ile</code> prototype for this device instance 
*/ 

HDMLDevice (HDMLDeviceProf ile profile) { 
super (profile) ; 

} 

/** 

* Retrieves the content encoding type supported by this device. 

* ©return <code>String</code> content type supported by this device. 
*/ 

public String getContentType () { 

return HDMLDeviceProf ile . CONTENT_TYPE ; 

} 
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* @ (#) GoWebRIMDeviceProf ile. java 
*/ 

package com . thinairapps .platform . device ,- 

import javax. servlet . * ; 
import j avax. servlet. http.*; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory 

* for GoWeb RIM devices 
*/ 

public class GoWebRIMDeviceProf ile extends HTTPDeviceProf ile { 



// serialVersionUlD for compatability with previous versions 
static final long serialVersionUID = 69949152053 6488575L ; 

/** name of this device profile */ 

public static final String NAME = "TA_GOWEB_RIM" ; 

/** user-agent transmitted with every request coming from devices^matching this profile 
*/ 

static final String USER_AGENT = "Go. Web/1.1 (compatible; HandHTTP 1.1; Mozilla/1.0; 
RIM950; compatible )"; 

/** content type accepted by all devices matching this profile */ 
static final String CONTENT_TYPE = "text/vnd.wap.wml" ; 

/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

creates . 

* @return <code>Class</code> of the <code>GoWebRIMDevice</code> instances that this 

profile generates. 

*/ 

public Class getDeviceClass ( ) { 

return new GoWebRIMDevice (this) .getClass () ; 

} 



/** 

* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</ code> 

*/ 

public String getNameO { return NAME; } 



/** 

* Determines whether the actual device making a request is of the type represented by 

* <code>GoWebRIMDeviceProf ile</code> . 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

GoWebRIMDevice</code>, false otherwise. 

*/ 

public boolean isRequestPromDevice (ServletRequest req) { 

if (super. isRequestPromDevice (req) ) { 

// now cast request to HttpServletRequest to retrieve and test user-agent header 
HttpServletRequest request = (HttpServletRequest) req; 
String userAgent = (String) request . getHeader ("user-agent"); 
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return ( (userAgent != null) && (userAgent . indexOf ( "Go . Web" ) >= 0) && (userAgent . ^ 
indexOf ("RIM") >=0}); 

// it's go web and it's rim, so return true... 

} 

return false; 



/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* @param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* (Sreturn <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest {ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest) req; 
GoWebRIMDevice device = new GoWebRIMDevice (this) ; 

// declare temp values for device properties, to checl<; for null 
String tempGUID, 

tempUserAgent , 

tempHost, 

tempRef erer , 

t empLanguage ; 

// initialize temps 

tempGUID = request .getHeader("x-ga-subno") ; 
tempUserAgent = request .getHeader ("User-Agent"); 
tempHost = request .getHeader ( "Host" ) ; 
tempReferer = request . getHeader ( "Ref erer ") ; 
tempLanguage = request . getHeader ( "Accept-Ijanguage" ) ; 

// **NEED TO VERIFY IF THIS IS ALWAYS UNIQUE** - gordogre 10/18/2000 

if (tempGUID != null) device . setGUlD ( GoWebRIMDeviceProf ile. NAME + ":" + tempGUID ); 
// COOKIES 

device . setCookies ( request . getCookies ()); 
// ACCEPT 

device . setAccept (request .getHeader ( "Accept" ) ) ; 
// USER-AGENT 

device . setUserAgent ( (tempUserAgent == null) ? STRING_N0_VALUE : tempUserAgent); 
// ACCEPT-LANGUAGE 

device . acceptlianguage = (tempLanguage == null) ? STRING_NO_VALUE : tempLanguage; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 
// REFERER 

device. ref erer = (tempReferer == null) ? STRING_NO_VALUE : tempReferer; 
return device; 



* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant. 
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* (gparam guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
public Device createDevice (String guid) { 

GoWebRIMDevice device = new GoWebRIMDevice (this) ; 

device . setGUID ( guid ) ; 

// initialize properties to NO_VALUE 
device . setUserAgent (STRING_NO_VALUE) ; 
device . acceptLanguage = STRING_NO_VALUE ; 
device, host = STRING_NO_VALUE ,• 
device . ref erer = STRING_NO_VALUE; 

return device; 



} // end 
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/** 

* @(#) GoWebRIMDevice. java 
*/ 

package com. thinairapps . plat form. device ; 

import javax. servlet . * ; 
import javax. servlet .http. * ; 

/** 

* ThinAirApps ' s abstraction for all RIM devices with GoWeb browsers 
*/ 

public class GoWebRIMDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 1155840S8963810933SL; 

protected String referer, host, acceptLanguage ; 

/** 

* Constructs a new <code>GoWebRIMDevice</code> instance of the type represented by ^ 

profile. • 

* @param profile <code>GoWebRIMDeviceProf ile</code> prototype for this device instance 
*/ 

GoWebRIMDevice (GoWebRIMDeviceProf ile profile) { 
super (profile) ; 

_- } 

m /** 

* Retrieves the content encoding type supported by this device. 

* ©return <code>String</code> content type supported by this device. 
*/ 

public String getContentType () { 

return GoWebRIMDeviceProf ile . CONTENT TYPE; 

} 

/** 

* Retrieves the domain of the device's gateway. 

* ©return <code>String</code> domain of request origin (gateway domain) 
*/ 

public String getRefererO { return referer; } 
/** 

* Retrieves the address of the host targeted by the request. 

* ©return <code>String</code> host targeted by request 
V 

public String getHost () { return host; } 
/** 

* Retrieves the language locale supported by the device. 

* ©return <code>String</code> language locale, if specified 
*/ 

public String getAcceptLanguage () { return acceptLanguage; } 
} // end 
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/** 

* @(#)GoWebPalniDeviceProf ile. java 
*/ 

package com . thinairapps . platform . device ; 

import j avax. servlet . * ; 
import j avax. servlet . http. * ; 

/** 

* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for GoWeb Palm devices 

*/ 

public class GoWebPalmDeviceProf ile extends HTTPDeviceProf ile { 



// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -5082728858823692866L; 

/** name of this device profile */ 

public static final String NfME = "TA_GOWEB_PALM" ; 

/** content type accepted by all devices matching this profile */ 
static final String CONTENT_TYPE = "text/vnd.wap.wml" ; 

/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

creates . 

* @return <code>Class</code> of the <code>GoWebPalmDevice</code> instances that this 

profile generates. 

*/ 

public Class getDeviceClass ( ) { return new GoWebPalmDevice ( this) . getClass ( ) ; } 
/** 

* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getName ( ) { return NAME; } 
/** 

* Determines whether the actual device making a request is of the type represented by 

* <code>GoWebPalmDeviceProf ile</code> . 

* @param request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

GoWebPalmDevice</code>, false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req) ) { 

// now cast request to HttpServletRequest to retrieve and test user-agent header 
HttpServletRequest request = (HttpServletRequest) req; 
String userAgent = (String) request .getHeader ("user-agent"); 

return (userAgent != null && userAgent . indexOf ( "Go .Web" ) >= 0 && userAgent. 
indexOf ("Palm") >=0) ; 

// it's go web and it's palm, so return true.. . 

} 
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* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletReguest request = (HttpServletRequest) req; 
GoWebPalmDevice device = new GoWebPalmDevice (this) ; 

// declare temp values for device properties, to check for null 
String tempGUID, 

tempUserAgent , 

tempHost , 

tempRef erer, 

tempLanguage ; 

// initialize temps 

tempGUID = request .getHeader ( "x-ga-subno" ) ; 
tempUserAgent = request . getHeader { "User- Agent ") ; 
tempHost = request .getHeader ( "Host" ) ; 
tempReferer = request .getHeader ( "Ref erer" ) ; 
tempLanguage = request .getHeader ( "Accept-Language" ) ; 

// **NEED TO VERIFY IF THIS IS ALWAYS UNIQUE** - gordogre 10/18/2000 

if (tempGUID != null) device . setGUID ( GoWebPalmDeviceProf ile .NAME + ":" + tempGUID ) ; 
// COOKIES 

device . setCookies (request . getCookies ( ) ) ; 
// ACCEPT 

device . setAccept ( request . getHeader ( "Accept " ) ) ; 
// USER- AGENT 

device. setUserAgent ( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent) ; 
// ACCEPT-LANGUAGE 

device .acceptLanguage = (tempLanguage == null) ? STRING_NO_VALUE : tempLanguage; 
// HOST 

device. host = (tempHost == null) ? STRING_NO_VALUE : tempHost; 

// REFERER 

device. ref erer = (tempReferer == null) ? STRING_NO_VALUE : tempReferer; 
return device; 

} 



/** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VALUE constant. 

* Oparam guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

GoWebPalmDevice device = new GoWebPalmDevice ( this ) ; 
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device . setGUID ( guid ) ; 

// initialize properties to NO_VALUE 
device . setUserAgent { STRING_NO_VALUE) ; 
device . acceptLanguage = STRING_NO_VALUE ; 
device. host = STRING_NO_VALUE ; 
device. referer = STRING_NO_VALUE; 

■ return device; 

} 



} // end 
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* @ {#) GoWebPalmDevice . java 
*/ 

package com . thinairapps .platform . device ; 

import javax. servlet . * ; 
import javax. servlet . http. * ; 

/** 

* ThinAirApps ' s abstraction for all devices with GoWeb browsers on the Palm® platform 
*/ 

public class GoWebPaliiiDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 138821043664431198L; 

protected String referer, host, acceptLanguage ; 

/** 

* Constructs a new <code>GoWebPalmDevice</code> instance of the type represented by ^ 

profile . 

* ©param profile <code>GoWebPalmDeviceProf ile</code> prototype for this device instance 
*/ 

GoWebPalmDevice (GoWebPalmDeviceProf ile profile) { 
super (profile) ; 

} 

S /** 

* Retrieves the content encoding type supported by this device. 

* ®return <code>String</code> content type supported by this device. 
*/ 

public String getContentType ( ) { 

return GoWebPalmDeviceProf ile .CONTENT_TYPE; 

} 

/** 

* Retrieves the domain of the device's gateway. 

* ©return <code>String</code> domain of request origin (gateway domain) 
*/ 

public String getRefererO { return referer; } 
/** 

* Retrieves the address of the host targeted by the request. 

* ©return <code>String</code> host targeted by request 
*/ 

public String getHostO { return host; } 
/** 

* Retrieves the language locale supported by the device. 

* ©return <code>String</code> language locale, if specified 
*/ 

public String getAcceptLanguage ( ) { return acceptLanguage; } 
} // end 
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/** 

* ® (#) EricssonWAPDeviceProf ile .java 
V 

package com. thinairapps .platform. device,- 

import javax. servlet . * ; 
import j avax. servlet .http. *; 

/** 

* Implements ThinAirApps • s standard <code>DeviceProf ile</code> and <code>Device</code> 

factory for Ericsson WAP phones. 

*/ 



public class EricssonWAPDeviceProf ile extends WAPDeviceProf ile { 



// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -915217898224689559L; 

/** name of this device profile */ 

public static final String NAME = "TA_ERICSSON_WAP" ; 



/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

creates . 

* ©return <code>Class</code> of the <code>EricssonWAPDevice</code> instances that this 

profile generates. 

*/ 

public Class getDeviceClass ( ) { 

return new EricssonWAPDevice (this) .getClass {); 

} 



* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getKTameO { return NAME; } 
/** 

* Determines whether the actual device making a request is of the type represented by 

* <code>EricssonWAPDeviceProf ile</code> . 

* @param request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

EricssonWAPDevice</code> , false otherwise. 

*/ 

public boolean isRequestFromDevice (ServletRequest req) { 

if (super . isRequestFromDevice (req) ) { 

// now cast request to HttpServletRequest to retrieve and test user-agent header 
HttpServletRequest request = (HttpServletRequest) req; 
String userAgent = (String) request . getHeader {"user-agent"); 

return (userAgent != null && 

( (userAgent . indexOf ( "Ericsson" ) >= 0) |j 
(userAgent. indexOf ("R380") >= 0) |1 
(userAgent. indexOf ("R320") >= 0) [j 
(userAgent. indexOf ("888") >= 0) ) ); 

} 



return false; 
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/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFromRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest) req; 
EricssonWAPDevice device = new EricssonWAPDevice (this ) ; 

// FIXME FIXME FIXME 

// sgross 6/14/2000: is this unique? 

// this is at best the device's IP address, not reliably unique - gordogre 10/18/2000 
// also need to check for null to avoid null pointer exception on substring(5) 
String tempGUID = request . getHeader ( "x-network- inf o" ) ; 

if (tempGUID != null) device . setGUID ( NAME + ":"+ tempGUID . substring ( 5 ) ) ; 



// declare temp values for device properties, to check for null 
String tempUserAgent , 

tempCharset , 

tempGateway, 

tempLanguage ; 

// initialize temps 

tempUserAgent = request .getHeader ("user-agent"); 
tempCharset = request . getHeader (" accept-charset ") ; 
tempGateway = request .getHeader ( "via" ) ; 
tempLanguage = request .getHeader ( "accept-language" ) ; 

// COOKIES 

device . setCookies (request . getCookies {)); 
// ACCEPT 

device . setAccept (request .getHeader ( "Accept" ) ) ; 
// USER- AGENT 

device. setUserAgent( (tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent); 
// CHAR- SET 

device. charset = (tempCharset == null) ? STRING_NO_VALUE : tempCharset; 

// GATEWAY 

device. gateway = (tempGateway == null) ? STRING_NO_VALUE : tempGateway; 
// ACCEPT LANGUAGE 

device . language = (tempLanguage == null) ? STRING_NO_VALUE : tempLanguage; 
return device; 



/** 

* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device. 
*<p> 

* This method initializes all device properties other than GUID to the appropriate \^ 

NO_VALUE constant. 

* ©param guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
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*/ 

public Device createDevice {String guid) { 

Erics sonWAPDevice device = new EricssonWAPDevice (this) ; 

device . setGUID ( guid ) ; 

// initialize properties to •NO_VALUE 
device . setUserAgent (STRING_NO_VALUE) ; 
device. charset = STRING_NO_VALUE ; 
device. gateway = STRING_NO_VALUE ; 
device . language = STRING_NO_VALUE ; 

return device; 

} 



} // end 
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/** 

* @ (#) EricssonWAPDevice . java 
*/ 

package com . thinairapps . platform . device ,- 

import j avax . servlet . * ; 
import javax. servlet -http. * ; 

/** 

* ThinAirApps' abstraction for the Ericcson family of WAP phones. 
*/ 

public class EricssonWAPDevice extends WAPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -7071206479514820282L; 

protected String host, charset, gateway, language; 

/** 

* Constructs a new <code>EricssonWapDevice</code> instance from this profile. 

* @param profile <code>EricssonWapDeviceProf ile</code> prototype used to create device. 
*/ 

EricssonWAPDevice (EricssonWAPDeviceProfile profile) { 
super (prof ile) ; 

} 

* Retrieves the language locale supported by the device. 

* ©return <code>String</code> language locale supported by client device. 
*/ 

public String getLanguage ( ) { return language; } 
/** 

* Retrieves the list of Character Set encodings supported by the device. 

* <p> 

J * The returned <code>String</code> may be contain more than one Character Set value, 
fi * in which case the the values will be returned as a comma delimeted list. 

* ©return <code>String</code> character set(s) supported by this device. 
*/ 

public String getCharsetO { return charset; } 
/** 

* Retrieves a description of the WAP gateway used by this device. 

* ©return <code>String</code> version of gateway used by this device 
*/ 

public String getGatewayO { return gateway; } 
} // end 
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/** 

* @ (#) AvantGoDeviceProf ile . j ava 
*/ 

package com. thinairapps .platform. device ; 

import com. thinair .utils . * ; 

import javax. servlet . ServletRequest ; 

import javax. servlet .http.HttpServletRequest; 



* implements ThinAirApps ' s standard <code>DeviceProf ile</code> and <code>Device</code> 
factory for AvantGo devices 

*/ 

public class AvantGoDeviceProf ile extends HTTPDeviceProf ile { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = 3548305456343669735L; 

/** name of this device profile */ 

public static final String NAME = ■• TA_AVANTGO " ; 

/** user-agent transmitted with every request coming from devices matching this profile 
*/ 

static final String USER_AGENT = "MozilIa/3.0 (compatible; AvantGo 3.2)"; 

/** content type accepted by all devices matching this profile */ 
static final String CONTENT_TYPE = "text/html"; 



/** 

* Retrieves the <code>Class</code> of the <code>Device</code> object that this profile 

* ©return <code>Class</code> of the <code>AvantGoDevice</code> instances that this 

profile generates. 

*/ 

public Class getDeviceClass ( ) { 

return new AvantGoDevice (this) .getClass () ; 

} 



/** 

* Retrieves the friendly name of this device type description. 

* ©return <code>String</code> A friendly name callers can use to refer to this <code> 

DeviceProf ile</code> 

*/ 

public String getNaraeO { return NAME; } 
/** 

* Determines whether the actual device making a request is of the type represented by 

* <code>AvantGoDeviceProf ile</code> . 

* ©param request the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>boolean</code> true if the requesting device is of type <code> 

AvantGoDevice</code>, false otherwise. 

*/ 

public boolean isRequestFromDevice ( ServletRequest req) { 

// check if device is an HTTP device 
if (super. isRequestFromDevice (req) ) { 

// cast req to HttpServletRequest to retrieve and check User-Agent 

HttpServletRequest request = (HttpServletRequest) req; 

String userAgent = (String) request .getHeader ( "User-Agent ") ; 
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// cannot check for equivalence with USER_AGENT constant since other versions of ^ 

AvantGo are possible - gordogre 
return (userAgent != null && userAgent . indexOf ( "AvantGo" ) >=0) ; 
} else 

return false; 



/** 

* Create a <code>Device</code> instance with the same properties as the actual 

* physical device that generated this servlet request. 

* ©param req the actual <code>ServletRequest</code> received by the ThinAir Server 

* ©return <code>Device</code> a device instance with properties set to describe the 

requesting device. 

*/ 

public Device createDeviceFroraRequest (ServletRequest req) { 

HttpServletRequest request = (HttpServletRequest) req; 
AvantGoDevice device = new AvantGoDevice (this) ; 

// declare temps for device properties for null checking 
String tempDeviceld, 

tempColorDepth, 

tempScreenSize , 

tempDeviceOS , 

tempUserlD, 

tempUserAgent , 

tempVersion, 

tempClientIP; 

// initialize temp properties 

tempDeviceld = request .getHeader ( "X-AvantGo-Deviceld" ) ; 
tempColorDepth = request .getHeader < "X-AvantGo-ColorDepth" ) ; 
tempScreenSize = request . getHeader ( "X-AvantGo-ScreenSize" ) ; 
tempDeviceOS = request . getHeader ( "X-AvantGo-DeviceOS " ) ; 
tempUserlD = request . getHeader { "X-AvantGo-Userld" ) ; 
tempUserAgent = request .getHeader ( "User- Agent ") ; 
tempVersion = request .getHeader ( "X-AvantGo-Verson" ) ; 
tempClientIP = request . getHeader ( "CI lent- ip" ) ; 



// the following 5 headers are base64 encoded, so we must first check for their 

presence before 
// decoding to avoid any null pointer exceptions 

// Deviceld may no longer be valid (10/17 gordogre) 

if {tempDeviceld != null) device . setGUID ( NAME + ":" + Base64 . decode (tempDeviceld) ) ; 

// ACCEPT 

device . setAccept (request .getHeader ( "Accept " ) ) ; 
// COOKIES 

device . setCookies (request .getCookies () ) ; 
// USER AGENT 

device. setUserAgent ((tempUserAgent == null) ? STRING_NO_VALUE : tempUserAgent ); 
// COLOR DEPTH 

device. colorDepth = (tempColorDepth == null) ? STRING_NO_VALUE : Base64 . decode ^ 
(tempColorDepth) ; 

// SCREEN SIZE 

device. screenSize = (tempScreenSize == null) ? STRING_NO_VALUE : Base64 . decode ^ 
(tempScreenSize) ; 

// DEVICE OS 

device. deviceOS = (tempDeviceOS == null) ? STRING_NO_VALUE : Base64 . decode xJ" 
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(tempDeviceOS) ; 
// USER ID 

device. userlD = (tempUserlD == null) ? STRING_NO_VALUE : Base64 . decode ( tempUserlD) ; 
// VERSION 

// if AvantGo version 3.1 is being used, X-AvantGo-Version will not be present - 
gordogre 

device .version = (tempVersion == null) ? STRING_NO_VALUE : tempVersion; 
// CLIENT IP 

// clientIP may no longer be valid - gordogre 

device. clientIP = (tempClientIP == null) ? STR.ING_NO_VAL,UE : tempClientIP; 

// SecureSync and onlineRequest headers only present when true, 
// so a value is always set (i.e. there is no "NO_VALUE" for these properties) 
device . secureSync = (request .getHeader ( "X-AvantGo-SecureSync " ) i= null) ? true : kf 
false; 

device . onlineRequest = (request .getHeader ( "X-AvantGo-OnlineRequest " ) != null) ? true i^' 
: false; 

return device; 



* Create a <code>Device</code> from a <code>String</code> device GUID 

* This method is used primarily by administrators to preconfigure an account 

* to include a device . 
*<p> 

* This method initializes all device properties other than GUID to the appropriate 

NO_VAIiUE constant. 

* ®param guid unique device ID - may be null 

* ©return a <code>Device</code> object representing an actual device 
*/ 

public Device createDevice (String guid) { 

AvantGoDevice device = new AvantGoDevice (this) ; 
device. setGUlD ( guid ); 

// initialize all properties to NO_VALUE 
device . setUserAgent ( STRING_NO_VALUE ) ; 
device. colorDepth = STRING_NO_VAIjUE ; 
device. screenSize = STRING_NO_VAIiUE ; 
device. deviceOS = STRING_NO_VALUE ; 
device. userlD = STRING_NO_VALUE ; 
device. version = STRING_NO_VALUE ; 
device. clientIP = STRING_NO_VALUE; 

return device ; 



} // end 
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/** 

* @ (#) AvantGoDevice . java 
*/ 

package com. thinairapps .platform. device; 

import javax. servlet . * ; 
import javax. servlet .http. *,- 

/** 

* ThinAirApps ' s abstraction for all devices with AvantGo browser version 3.2 

V 

public class AvantGoDevice extends HTTPDevice { 

// serialVersionUID for compatability with previous versions 
static final long serialVersionUID = -2822887137691798848L; 

protected String version, colorDepth, screenSize, deviceOS, userlD, clientIP; 
boolean onlineRequest , secureSync ; 

/** 

* Constructs a new <code>AvantGoDevice</code> instance of the type represented by 

profile . 

* ©param profile <code>AvantGoDeviceProf ile</code> prototype for this device instance 
*/ 

AvantGoDevice (AvantGoDeviceProf ile profile) { 
super (profile) ; 

/** 

y * Retrieves the content encoding type supported by this device. 

* ©return <code>String</code> content type supported by this device 
public String getContentType () { return AvantGoDeviceProf ile . CONTENT_TYPE ; } 
/** 

* Retrieves the version of the AvantGo browser this device is running. 

* ©return <code>String</code> client verison number 
public String getVersion() { return version; } 

/** 

* Retrieves the color depth of the screen for the device. 

* ©return <code>String</code> color depth of device 
*/ 

public String getColorDepth ( ) { return colorDepth; } 

* Retrieves the screen size of the device. 

* <p> 

* The returned value will be in the format "HxW", where H is the height of the screen 

* in pixels, and W is the width of the screen in pixels. 

* ©return <code>String</code> screen size of the device. 
*/ 

public String getScreenSize ( ) { return screenSize; } 
/** 

* Retrieves a description of the operating system running on the device. 

* ©return <code>String</code> get device operating system 
*/ 

public String getOS ( ) { return deviceOS; } 
/** 

* Retrieves the AvantGo User Id for the user making the request . 

* ©return <code>String</code> AvantGo user id for person using this device 
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*/ 

public String getUserldO { return userlD; } 
/** 

* Retrieves logical flag indicating an online request. 

* <p> 

* Devices using the AvantGo browser may be making an online request or an offline ^ 

* When a request is an offline request, the AvantGo application caches the contents of 

the requested 

* page for offline viewing on a device following a device synchronization. When a 

request is an online 

* request, the user is interacting with the requested material in real time. 

* ©return <code>boolean</code> true if request is an online request, false if request wr 
is an offline request. 

*/ 

public boolean isOnlineRequest ( ) { return onlineRequest ; } 
/** 

* Retrieves logical flag indicating that a request has been made via a secure connectionw? 

* ©return <code>boolean</code> true if request is using a secure connection, false 
otherwise . 

*/ 

public boolean isSecureSync { ) { return secureSync; } 
/** 

* Retrieves the IP address of the device. 

* <p> 

* This value may not be available for all requests, and may not be unique for all \^ 

devices . 

* ©return <code>String</code> ip address of client device */ 
public String getClientlPO { return clientIP; } 

iS // end 
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Wireless SDK for ThinAir server 



About this sample 



This is a very simple 'Hello World' Connector that serves as an introduction to 
building custom applications using the the ThinAir connector API. The Hello 
world connector recognizes what device is contacting it and returns a simple 
message in the markup language for that device. This connector demonstrates: 

1. A simple use of the ThinAirserver's Device detection ability 

2. The use of different Tag libraries to render markup specific to each device 

3. The ability for a connector to process configuration file information. The 
connector will append the value for secretMessage in connector. im to its 
output. 



aequi rements 

This sample requires the following SDK jars: 

* platform. jar 

* taglib. jar 

* devices. jar 



sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file 
Helloworldconnector. class - compiled Java code 
/src - Java source files 



Building the sample 



compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir server's /connectors subdirectory, given a name 
of your choice. 

start the ThinAir server, it will load the sample code and begin executing it. 



using the Sample 



wait until the Thi nAi rServer has started and the Hello world Connector has been 
loaded and initialized. From your wireless device, enter the ip address listed 
as the value for ApplicationPath in connector.ini (your Thi nAi rServer IP 
address), followed by /sarapl es/hel loworl d . For a machine with IP address 
111.222.12.34 this would be: 
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http : //111 . 222 . 12 . 34/sainpl es/hel 1 oworl d 
Follow the on-screen -instructions. 



Last updated: 11.13.2000 
copyright 1999, 2000 Thi nAi rApps Inc. 



Page 2 



C:\TASS\ ■ ■ \General\HelloWorld\src\HelloWorldConnector. java 



1 



/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir Platform imports 

import com. thinairapps. platform. connector. *; 
import com . thinairapps .platform. device . * ; 

//ThinAir Tag Libraries imports 
import com. thinairapps. tag.*; 
import com . thinairapps . tag . wml . * ; 
import com. thinairapps .tag .html . * ; 
import com . thinairapps . tag . hdml . * ; 

//Standard Java imports 
import java .util . * ; 

/* 

* This is a sample Connector Application for use with ThinAir Server 

* It's purpose is to demonstrate how to write a simple connector, that 

* is able to use the device determination capabilites of the platform. 

^l 

;r|>ublic class HelloWorldConnector implements Connector 

lid 

//private members for the application's user 
private String SecretMessage = null; 

/** 

* initO is called by the ThinAirServer when the Connector is loaded. It provides 

* the Connector with resources it needs to interact with the ThinAirServer. 

* ©param applicationName friendly name of the application 

* ©param applicationPath URL path on which the server is hosting this Connector 

* ©param appProps properties loaded from the "connector.ini" file 

* ©param ca ConnectorAccess object to support profiles, sessions, and provider access 

* ©param applicationLog is used for Logging 

'i; */ 

public void init (String applicationName, String applicationPath, Properties appProps, 
ConnectorAccess ca, ApplicationLog al) 

{ 

//load "SecretMessage" property from "connector.ini" file 
SecretMessage = appProps .getProperty ( "SecretMessage" ) ; 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming ^ 
request from a 

* particular device, and returns an appropriate response. This method is called wheneveri^ 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of \i 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 

* ©param props Device's request properties (i.e. http GET or POST arguments) 

* ©param device Device making the request 
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* ©param out OutputStream to write results to 
*/ 

public void handle (Properties props. Device device, OutputStream out) throws lOException 
{ 

// hold the return markup 
String result = null; 

// generate a simple message in the rendering format of the requesting device 

if (device instanceof WAPDevice) 
{ 

// WML parsing WAP device 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

com. thinairapps. tag. wml. Head head = new com . thinairapps . tag . wml .Head () ; 

com. thinairapps . tag . wml .Meta meta = new com . thinairapps . tag . wml . Meta \^ 

("http-equiv" , " Cache- Control " , "max-age=0 " ) ; 
head. addChild (meta) ,- 
deck. addChild (head) ; 

com. thinairapps . tag. wml .DisplayCard card = new com. thinairapps . tag .wml . wf 

DisplayCardC'HelloWorld", "Hello World"); 
card. buildCard( "Hello WAP User! "+SecretMessage, com. thinairapps . tag . wml . 

Paragraph. ALIGN_LEFT) ; 
deck. addChild (card) ; 



result = deck . render () ; 

} 

else if (device instanceof HDMLDevice) 
{ 

// HDML parsing HTTP device 

HDMLTagDocuraent deck = new HDMLTagDocument ( ) ; 

com. thinairapps . tag . hdml .DisplayCard card = new com. thinairapps . tag . hdml . 
DisplayCard ( ) ; 

card. addChild (new FormattedLine ( "Hello HDML User! "+SecretMessage, \^ 

Format tedLine .LEFT) ) ; 
deck. addChild (card) ; 



result = deck . render () ; 



else 
{ 



// HTML parsing HTTP device 
HTMLTagDocument doc = new HTMLTagDocument { ) ; 

com. thinairapps . tag . html . Head head = new com. thinairapps . tag . html . Head () ; 
com. thinairapps . tag .html .Meta meta = new com. thinairapps . tag .html .Meta 

("name", " PalmComputingPlatf orm" , "true"); 
head. addChild (meta) ; 

com. thinairapps . tag .html .Title title = new com. thinairapps . tag. html .Titlei^ 

("Hello World") ; 
head. addChild (title) ; 
doc . setHead (head) ; 

com. thinairapps . tag . html . Body body = new com . thinairapps . tag . html . Body () ; 
com. thinairapps . tag . html . Font font = new com . thinairapps . tag .html . Font 
( "geneva, arial " , 3); 

com. thinairapps . tag .html .Text text ; 
if (device instanceof GoWebRIMDevice) 

text = new com. thinairapps . tag . html .Text ( "Hello GoWeb User! "+ ^ 
SecretMessage) ; 

else 

text = new com . thinairapps . tag . html . Text ( "Hello HTTP User! "+ ^ 
SecretMessage) ; 

font.addChild( text ); 
body. addChild (font) ; 
doc .addChild (body) ; 



result 



= doc . render ( ) ; 
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// write result to the output stream 
out .write (result .getBytes () ) ; 

} 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a \l 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing ^ 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used ^ 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName () method. 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of ^ the devices this \i 

Connector supports . 

*/ 

public String [] getDevicesO 
{ 

String devices [] = 
{ 

UPWAPDeviceProf ile. NAME, PalmVIIDeviceProf ile .NAME , 
AvantGoDeviceProf ile . NAME , HDMLDeviceProf ile . NAME , 
GoWebRIMDeviceProf ile .NAME, HTMIjDeviceProf ile .NAME 

}; 

return devices; 

} 

:l 
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Devi ceDetecti ve 
a.k.a. Inspector Gadget 
sample Connector 
Wireless SDK for ThinAir server 



About this Sample 



The Devi ceDetecti ve sample Connector: 

1. Demonstrates how to use the Device detection features of the ThinAir Server 

2. Showcases the Device objects and how they function in a working Connector 

3. Demonstrates the various Tag Libraries that render markup for different 
devices using a simple, uniform API 



with this connector you will be able to contact your Thi nAi rserver 
with almost any wireless device, and have it automatically map your actual 
device to one of several built-in 'ThinAir Device Profiles'. The Device 
Profiles will generate a Device object with the same properties as your 
actual device, properties might include things like screen size, color depth, 
and number of soft keys. The Connector will return a page, in your device's 
own markup language, listing the properties it detected along with the Device's 



Por instructions on how to build your own Device Profiles, consult the 
Developer's Guide. 



Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

* devices. jar 



sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file 
Devi ceDetecti ve. jar - compiled Java code 
/src - Java source files 



Building the sample 



Compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your CLASSPATH. 

Install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 

start the ThinAir Server; it will load the sample code and begin executing it. 
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using the Sample 
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wait until the ThinAi rserver has started and the Device Detective connector has 
been loaded and initialized. From your wireless device, enter the IP address 
listed as the value for ApplicationPath in connector.ini (your ThinAi rserver IP 
address), followed by /samples/device. For a machine with IP address 
111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sainpl es/devi ce 

supported devices include: WAP phones, HDML phones, Palm Pilots, Windows CE 
devices, desktop web browsers, and GO America/GO RIM pagers, in order to build 
a Palm Query Application (PQA) that works with DeviceDetective, you 
will need to understand and use "web clipping" technology from Palm, web 
Clipping involves essentially creating html interfaces into your applications. 
For your convienence, an HTML file CdeviceDetective.html) has been provided for 
this purpose. To find out more about creating pqas and web Clipping 
technology, visit: http://www.palmos.com/dev/tech/webclipping/ 



Last updated: 11.13.2000 
copyright 1999, 2000 ThinAi rApps inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir device library imports 

import com. thinairapps .platform. device . * ; 

//ThinAir Tag Libraries imports 
import com. thinairapps . tag. * ; 
import com. thinairapps . tag . wral . * ; 

//Standard Java imports 
import java.util . * ; 



/** 

* This utility class renders output as WML for a variety of devices 
*/ 

class WMLRenderer 
{ 

/** 

* Build a card with a welcome message that identifies the device to the user 

* ©param deviceName String of Device name to be displayed 

* Sparam keys[] String array of keys to be displayed 

* @param values [] String array of values to be displayed 

* ©return String of formatted WML 
1 */ 

static String buildCard (String deviceName, String keys[]. String values!]) 
{ 

: ■ WMLTagDocument deck = new WMLTagDocument ( ) ; 

Head head = new HeadO ; 

Meta meta = new Meta ( "http-equiv" , " Cache - Cont rol " , "max-age=0 " ) ; 

// this is to test cache control at the deck level... 
double rnd = Math . random () ; 

Meta meta2 = new MetaC'name", String. valueOf (rnd) , "max-age=0 " ) ; 
head. addChild (meta) ; 
head.addChild(meta2) ; 
deck. addChild (head) ; 

DisplayCard card = new DisplayCard ( "device" , "Inspector Gadget"); 
Paragraph p = new Paragraph (Paragraph .ALIGN_CENTER, Paragraph . MODE_NOWRAP) ; 

StringBuffer sb = new StringBuf fer (56) ; 
sb.append( "<b>Welcome "); 
sb. append (deviceName) ,- 
sb. append ( "</b>" ) ; 



p.addChild( new Text ( sb . toString (). trim () ) ); 
card. addChild (p) ; 

// print out the properties of the device 
// as key: value pairs 

p = new Paragraph ( Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 
p. addChild (new Text ( "Device Properties : <br/ >")) ; 



Break br = new Break ( ) ; 

for (int i = 0; i < keys. length; i++) 



C: \TASS\WirelessSDK\ . . \General\DeviceDetection\src\WMLRenderer. java 



2 



p.addChild(new Text (keys [i] + ": " + values [i] )) ; 
p.addChild(br) ; 

} 



card.addChild(p) , 



deck. addChild (card) ; 
return deck. render () ; 



* ©param device used to retrieve WAPdevice values 

* ©return page welcoming a user of a basic WAP devic 
*/ 

static String getMessage (WAPDevice device) 



String keys[3 = new String [4] ; 
keys[0] = "GUID" ; 
keys[l] = "Protocol"; 
keys [2] = " Content- Type " ; 
keys [3] = "User-Agent"; 

String values [] = new String [4] ; 
values[0] = device .getGUID 0 ; 
valuesfl] = device .get Protocol 0 ; 
values [2] = device . getContentType () ; 
values [3] = device . getUserAgent () ; 

buildCardC device . getProfile () .getName () , keys, 



* ©param device used to retrieve GoWebRimDevice values 

* ©return page welcoming a user of a GoWeb device 
*/ 

static String getMessage (GoWebRIMDevice device) 
{ 

String keys[] = new String[4]; 
keys[0] = "GUID"; 
keys[l] = "Protocol"; 
keys [2] = " Content- Type " ; 
keys [3] = "User-Agent"; 

String values [] = new String [4] ; 
valuesIO] = device. getGUID () ; 
valuesll] = device -getProtocol () ; 
values[23 = device .getContentType () ; 
valuesI3] = device . getUserAgent () ; 

return buildCardC device .getProfile () .getName () , keys, values); 



* @parm device used to retrieve Unwired Planet WAP device values 

* ©return page welcoming a user of a basic UP/WAP device 
*/ 

static String getMessage (UPWAPDevice device) 
{ 
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String keys[] = new String [14]; 

keys[0] = "QUID" ; 

keys[l] = "Protocol"; 

keys [2] = "Content-Type"; 

keys [3] = "User-Agent"; 

keys [4] = "Language"; 

keys [5] = "Smart Dialing"; 

keys [6] = "Screen Depth"; 

keys [7] = "Color"; 

keys [8] = "Alert"; 

keys [9] = "Max PDU" ; 

keys [10] = "Soft Keys"; 

keys [11] = "Screen Chars"; 

keys [12] = "Pixel Width"; 

keys [13] = "Pixel Height"; 



String values [] = new String [14]; 
values[0] = device.getGUIDO ; 
values[l] = device. getProtocol 0 ; 
values [2] = device .getContentType 0 ; 
values [3] = device . getUserAgent () ; 
values [4] = device . getLanguage () ; 

values[5] = String. valueOf (device. isSmartDialing 0 ) ; 
values[6] = String -valueOf (device. getScreenDepth 0) ; 
values[7] = String .valueOf (device. isColorO ) ; 
values[8] = String .valueOf (device. immediateAlert ()) ; 
values[9] = device . getMaxPDU () ; 

valuestlO] = String .valueOf (device . numSoftKeys ()) ; 
values[ll] = device. getScreenChars () ; 

values[12] = String . valueOf (device . getPixelWidth ()) ; 
values[13] = String.valueOf (device. getPixelHeight 0 ) ; 



return buildCard( device .getProfile 0 .getName () , keys, values); 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir device library imports 

import com . thinairapps . pi at form. device . * ; 

//ThinAir Tag Libraries imports 
import com. thinairapps . tag .* ; 
import com. thinairapps . tag . html . * ; 

//Standard Java imports 
import java .util . * ; 

/* 

* This utility class renders output as HTML for a variety of devices 
*/ 

class HTMLRenderer { 
/** 

* Build a card with a welcome message that identifies the device^ to the user 

* ©param deviceName String of Device name to be displayed 
□ * @param keys [] String array of keys to be displayed 

* ©param values [] String array of values to be displayed 

* ©return String of formatted HTML 
*/ 

static String buildCard (String deviceName, String keys [] , String values!]) 
{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
Head head = new Head { ) ; 

Meta meta = new MetaC'name", "PalmComputingPlatf orm" , "true"); 
head.addChild(meta) ; 

head. addChild (new Title (" Inspector Gadget")) ; 

doc . setHead (head) ; 

== Body body = new Body ( ) ; 

Font font = new Font ( "geneva, arial " , 3) ; 

Center center = new Center () ; 

StringBuffer sb = new StringBuf fer (56) ,- 
sb. append ( "<B>Welcome "); 
sb. append (deviceName) ; 
sb. append ( "</B>" ) ; 

center. addChild ( new Text ( sb . toString (). trim () ) ) ; 

font .addChild (center) ; 
font. addChild (new Break ( ) ) ; 

// print out the properties of the device 
//as key: value pairs 

font .addChild (new Text("Device Properties : <BR> ")) ; 

Break br = new Break ( ) ; 

for (int i = 0; i < keys. length; i++) 

{ 

font. addChild (new Text(keys[i] + ": " + values[i])); 
font.addChild(br) ; 

} 



body. addChild (font) ; 
doc. setBody (body) ; 
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* Oparm device used to retrieve HTML device values 

* (Sreturn String consisting of a page welcoming a user of a basic HTML device 
*/ 

tatic String getMessage (HTMLDevice device) 

String keysL] = new String [4] ; 
keys[0] = "GUID" ; 
keys [1] = "Protocol"; 
keys [2] = " Content- Type " ; 
keys [3] = "User-Agent" ; 

String values [] = new String [4]; 
valuesCO] = device. getGUID 0 ; 
values[l] = device .getProtocol 0 ; 
values [2] = device . getContentType () ; 
values [3] = device . getUserAgent () ; 

buildCardC device . getProfile (). getName () , keys, values); 



* @param device used to retrieve values from PalmVIIDevice 

* ©return page welcoming a user of a PalmVIIDevice device 
*/ 

static String getMessage (PalmVIIDevice device) 
{ 

String keys[] = new String [4] ; 
keys[0] = "GUID" ; 
keys[l] = "Protocol"; 
keys [2] = " Content -Type " ; 
keys [3] = "User-Agent"; 

String values [] = new String[4]; 
values [0] = device .getGUID () ; 
values [1] = device .getProtocol 0 ; 
values[2] = device .getContentType () ; 
values[3] = device .getUserAgent {) ; 

return buildCard( device .getProfile () .getName () , keys, v 



/** 

* ©pararn device used to retrieve values from AvantGoDevice 

* ©return page welcoming user of AvantGoDevice 
*/ 

static String getMessage (AvantGoDevice device) 
{ 

String keys[] = new String[ll]; 
keys[0] = "GUID"; 
keys[l] = "Protocol"; 
keys [2] = " Content- Type " ; 
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keys [3 ] = 

keys [4] = 

keys [5] = 

keys [6] = 

keys [7] = 

keys [8] = 

keys [9] = 
keys [10] = 

String val 



values 
values 
values 
values 
values 
values 
values 
values 



alu. 



'User-Agent " ; 



ies[] = new String [11] ; 

: device. getGUIDO ; 

: device . getProtocol ( ) ; 

: device. getContentType 0 ; 

■ device . getUserAgent {) ; 

: device. getVers ion () ; 

: device .getColorDepth 0 ; 

: device .getScreenSize () ; 

: device -getOS () ; 

: device.getUserldO ; 

■- String .valueOf ( device . isOnlineReguest ( ) ); 
= device .getClientIP 0 ; 



. buildCard( device . getProfile (). getName {) , keys. 



* (Sparam device used to retrieve values from PocketlEDevice 

* ©return page welcoming user of PocketlEDevice 
*/ 

static String getMessage (PocketlEDevice device) 
{ 

String keys[] = new String [7]; 
keys[0] = "QUID"; 
keys[l] = "Protocol" ; 
keys [2] = "Content -Type " ; 
keys [3] = "User- Agent " ; 
keys [4] = "Color Depth" ; 
keys [5] = "Screen Size"; 
keys [6] = "OS"; 

String values [] = new String [7] ; 
values [0] = device .getGUlD () ; 
values[l] = device .getProtocol () ; 
values [2] = device. getContentType () ; 
values[3] = device -getUserAgent 0 ; 
values [4] = device .getColorDepth () ; 
values[5] = device. getScreenSize 0 ; 
values [6] = device. getOS () 

return buildCard( device .getProfile () .getName () , keys, values); 

} 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS , INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir device library imports 

import com . thinairapps .platform. device . * ; 

//Thinair tag libraries imports 
import com. thinairapps. tag.*; 
import com. thinairapps . tag .hdml . * ; 

//Standard Java imports 
import java.util.*; 

/** 

* This utility class renders output as HDML for a variety of devices 
*/ 

class HDMLRenderer 
{ 

/** 

* Build a card with a welcome message that identifies the device to the user 

* (Sparam deviceName String of Device name to be displayed 

* @param keys [] String array of keys to be displayed 

* @param values [] String array of values to be displayed 

* ©return String of formatted HDML 
*/ 

static String buildCard (String deviceName, String keys[]. String values []) 
{ 

HDMLTagDocument deck = new HDMLTagDocument { ) ; 

DisplayCard card = new DisplayCard ( ) ; 

StringBuffer sb = new StringBuf f er ( 56 ) ; 
sb . append ( "Welcome " ) ; 
sb . append ( devi ceName ) ; 

card. addText (new FormattedLine ( sb . toString ( ) . trim () , ForraattedLine . CENTER) ) ; 
card. addChild (new Break ( ) ) ; 



card.addChild(new FormattedLine ( "Device Properties : <BR> " , FormattedLine . LEFT) ) ; 

Break br = new Break () ; 

for (int i = 0 ; i < keys. length; i++) 

card. addChild (new FormattedLine (keys [i] + ": " + values [i], ForraattedLine. LEFT) ) ; 
card. addChild (br) ; 

} 

deck. addCard (card) ; 
return deck . render ( ) ; 

} 



/** 

* Retrive values from HDML device and generates page 

* @parm device used to retrieve HDML device values 

* ©return String consisting of a page welcoming a user of a basic HDML device 
*/ 

static String getMessage (HDMLDevice device) 
{ 
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String keys[] = new String [4] ; 
k;eys[0] = "QUID"; 
keys[l] = "Protocol"; 
keys [2] = " Content- Type " ; 
keys [3] = "User-Agent"; 

String values [] = new String [4]; 
values[0] = device.getGUIDO ; 
values[l] = device. getProtocol {] ; 
values[2] = device. getContentType 0 ; 
values[3] = device .getUserAgent () ; 



return buildCard( device .getProfile {) .getName () , keys, values); 

} 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Thinairapps Imports 

import com. thinairapps . platform . connector . * ; 
import com. thinairapps . platform. device . * ; 

//Standard Java Imports 
import java.net.*; 
import j ava . io . * ; 
import j ava . ut i 1 . * ; 



/** 

* This Connector demonstrates ThinAir Server's facilities for detecting devices and kT 

rendering 

* content conditionally using different Tag Libraries 
*/ 

public class DeviceDetective implements Connector 
{ 

private ConnectorAccess connectorAccess ; 
J private String path; 



/**Called by the ThinAirServer when the Connector is loaded. It provides the Connector kT 
with 

* resources it needs to interact with the ThinAirServer. 

* For more information about the Connector interface, see the javadocs for the ThinAir ^ 

Server API 

* (Sparam applicationName is a String derived from connector.ini. 

* @param applicationPath is a String derived from connector.ini. 

* (Sparam connect orProps is a Properties list containing developer assigned 

connector- specif ic properties. 

* ©param connectorAccess is our access point to the services provided by ThinAir Server. 

* @param applicationLog is used for logging 
*/ 

public void init (String name, String p. Properties iniProps, ConnectorAccess ca, 
ApplicationLog al) 

{ 

connectorAccess = ca; 
path = path; 

} 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing i/T 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getNameO method. 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this ^ 

Connector supports. 

*/ 

public String [] getDevicesO 
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String devices [] = 
{ 

AvantGoDeviceProf lie. NAME, 
GoWebPalmDeviceProf ile .NAME, 
GoWebRIMDeviceProf ile .NAME , 
HDMLDeviceProf ile . NAME , 
HTMIiDeviceProf ile .NAME , 
NokiaWAPDeviceProf ile .NAME, 
PalmVI IDeviceProf il e . NAME , 
PocketlEDeviceProf ile .NAME, 
UPWAPDeviceProf ile .NAME, 
WAPDeviceProf ile . NAME 

return devices 



/**The handle method implements the core logic of a Connector. It takes an incoming 
request from a 

* particular device, and returns an appropriate response. This method is called wheneveri^ 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into \i 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 

* ©param props a set of name value pairs corresponding to the HTTP request parameters ^ 

from the device. 

* @param device a Device object created in the image of the actual device making this 

* @param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle (Properties reqProps, Device device, OutputStream out) throws \e 
lOException 

{ 

// hold the return markup 
String result = null; 

try 
{ 

// determine which device is contacting the Connector and use a different 
// rendering class to generate output 
if (device instanceof HDMLDevice) 

result = HDMLRenderer .getMessage ( (HDMLDevice) device ); 

else if (device instanceof AvantGoDevice) 

result = HTMLRenderer .getMessage ( (AvantGoDevice) device ); 

else if (device instanceof GoWebPalmDevice) 

result = HTMLRenderer .getMessage ( (HTMLDevice) device ) ; 

else if (device instanceof PocketlEDevice) 

result = HTMLRenderer .getMessage ( (PocketlEDevice) device ) ,- 

else if (device instanceof PalmVIIDevice) 

result = HTMLRenderer .getMessage ( (PalmVIIDevice) device ) ; 

else if (device instanceof HTMLDevice) 

result = HTMLRenderer. getMessage ( (HTMLDevice) device ) ; 
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else if (device instanceof GoWebRlMDevice) 

result = WMLRenderer . getMessage ( (GoWebRlMDevice) device ) ; 

else if (device instanceof NokiaWAPDevice) 

result = WMLRenderer .getMessage ( (NokiaWAPDevice) device ); 

else if (device instanceof UPWAPDevice) 

result = WMLRenderer. getMessage ( (UPWAPDevice) device ) ; 

else if (device instanceof WAPDevice) 

result = WMLRenderer .getMessage ( (WAPDevice) device ); 



result = "ERROR: Device " +device .getClass () + " not supported."; 

} 

catch (Exception e) 
{ 

e .printStackTrace ( ) ; 

result = "ERROR: "+e .getMessage () ; 

} 



out.write( result .getBytes ( ) ) ; 



Setup Page 1 of 1 

Inspector Gadget 
Press GO and I will discover your device automatically: 
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Database connector sample connector 
wireless SDK for ThinAir Server 



About this Sample 



Requi rements 



This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

* device. jar 



Sample Files 



This sample consists of the foil owing file tree: 
connector.ini - connector configuration file 
DBConnector. class - compiled Java code 
/src - java source file - DBconnector. java 



Building the Sample 



install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 



Start the ThinAir server, it will load the sample code and begin executing it. 



using the Sample 

wait until the ThinAirserver has started and the DBconnector has 
been loaded and initialized. From your wireless WML device, or web browser, 
enter the IP address listed as the value for ApplicationPath in connector.ini 
(your ThinAirserver IP address), followed by /sampl es/DBconnector . For a 
machine with IP address 111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/DBconnector 

Follow the on-screen instructions. 



Last updated: 11.13.2000 

page 1 



README.txt 

copyright 1999, 2000 ThinAirApps Inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//ThinAir Platform import 

import com . thinairapps . platform. connector . * ; 
import com. thinairapps .platform. device . * ; 

//ThinAir Tag Libraries import 
import com. thinairapps . tag . html . * ; 
import com. thinairapps . tag . wml . * ; 

import java.io.*; 
import java.util.*; 
import j ava . sql . * ; 



/* 

* This is a sample Connector Application for use with ThinAir Server 1.2. Its 

* purpose is to demonstrate a simple connection to a database utilizing the 

* ThinAir Connector API. A ODBC connection to the Microsoft Access Northwind 

* Database needs to be established with the DSN name of "Northwind". 
1/ 

public class DBconnector implements Connector 
{ 

1= private String appname; 

jij private ConnectorAccess connectaccess ; 



/** 

* initO is called by the ThinAirServer when the Connector is loaded. It 

* provides the Connector with resources it needs to interact with the 

* ThinAir Server. For more information about the Connector interface, see 

* the javadocs for the ThinAir Server API 

* ©param applicatiohName is a String derived from connector.ini. 

* ©param applicationPath is a String derived from connector.ini. 

* ©param connectorProps is a Properties list containing developer assigned 

* connector-specific properties. 

* ©param connectorAccess is our access point to the services provided by 

* ThinAir Server. 

* ©param applicationLog is used for logging. It is not utilized in this 

* sample 
*/ 

public void init (String name, String p, Properties iniProps, ConnectorAccess ca, ^ 
ApplicationLog al) 

{ 

//Since we do not use any of the above in this sample, this area is blank 
) 



/** 

* getDevicesO is called once by the ThinAir Server during start-up. It 

* allows a Connector to indicate the types of devices it supports. 

* getDevicesO returns an array containing the names of all DeviceProf iles 

* supported by this Connector. These names are the friendly names used to 

* uniquely identify every DeviceProf ile . To get the friendly name of a 

* particular device, refer to the ThinAir Server Developer Guide or call 

* DeviceProf ile ' s getName ( ) method. 

* For more details about device detection and handling see the Device 

* Detective sample Connector and the ThinAir Server Developer Guide. 
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* ©return an array of Strings representing the friendly names of the 

* devices this Connector supports. 
*/ 

public String [] getDevicesO 

{ 

String [] devices = { " TA_WAP " , " TA_HTML " } ; 
return devices; 

} 



* The handle method implements the core logic of a Connector. It takes an 

* incoming request from a particular device, and returns an appropriate 

* response. This method is called whenever the server receives a request 

* from a type of device that the Connector indicates it supports, destined 

* (as indicated in the request URL) for a specific application. It is the 

* responsibility of the Connector to interpret the request and generate an 

* appropriate response. 

* The server will pass a Device object containing as much information as 

* possible into this method. The Connector can then utilize the particular 

* Device class to determine more detailed information on the capabilities 

* of the particular device making the request. 

* @param props a set of name value pairs corresponding to the HTTP request 

* parameters from the device. 

* @param device a Device object created in the image of the actual device 

* making this request. 

* ©param result a reference to the OutputStream that will be returned to 

* the device . 
*/ 

public void handle (Properties reqProps, Device device, OutputStream out) throws 
lOException 

{ 

//Find out what action the user is trying to perform 
string action = reqProps . getProperty ( "act ion" ) ; 
String output = null; 
String message = null; 

//If this is the first time entry , then action would be null. 
//We then produce a welcome screen 
if (action == null) 
{ 

/ /Detect what type of device the user has 

if (device instanceof WAPDevice) 

{ 

//Since this is a WAP device, generate WML. Below is the WML and how the WML tagi^ 
libraries are used to generate it 

//<wml><card id="main" title="Welcome" ><p>Welcome to the Database Sample App<br/>i^' 

Please choose from the f ollowing . . . </br> 
//<anchor> <go href = " . /DBconnector?action=l">Select statement l</go></anchor></ 

brxanchorxgo href = " . /DBconnector?action=2 " >Select statement 2</go></ 

anchor> 
//</p></card></wml> 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( "Welcome" ) ; 

com . thinairapps . tag . wml . Paragraph p = new com. thinairapps . tag . wml . Paragraph (com . ^ 
thinairapps . tag . wml . Paragraph . ALIGN_LEFT , com . thinairapps . tag . wml . Paragraph . ^ 
MODE_WRAP) ; 

p.addChild{new com. thinairapps . tag . wml . Text (" <b>Welcome to the Database Sample ^ 
App</b>") ) ; 

p .addChild(new com. thinairapps . tag .wml . Break ( ) ) ; 

p.addChild{new com. thinairapps . tag . wml . Text ( "Please choose from the following ^ 
...")); 



C: \TASS\WirelessSDK\Samples\General\Database\src\DBconnector ■ java 



3 



p.addChild (new com . thinairapps . tag . wml . Break ( ) ) ; 

com. thinairapps.tag.wml .Go go = new com. thinairapps . tag .wml .Go (". /DBconnector? 

action=l", true, com . thinairapps . tag. wml .Go .METHOD_GET) ; 
com. thinairapps . tag .wml -Anchor anchor = new com. thinairapps . tag . wml .Anchor (go, new 

com. thinairapps . tag .wml . Text ( "Query 1")) ; 

p.addChild (anchor) ; 

p.addChild (new com. thinairapps . tag .wml .Break () ) ; 

go = new com. thinairapps . tag . wml . Go (". /DBconnector?action=2 " , true. Go. \^ 
METHOD_GET) ; 

anchor = new com . thinairapps . tag . wml .Anchor (go, new com . thinairapps . tag .wml . Text 
("Query 2") ) ; 

p . addChild (anchor) ; 

p.addChild (new com. thinairapps . tag . wml . Break () ) ; 
card.addParagraph(p) ; 

deck. addCard (card) ; 

//render the card and then output 
out .write (deck. render ( ) .getBytes () ) ; 
} 

else 

//If it is not WML, then it can only be HTML. Below is the actual HTML and how 
the HTML tag libraries are used to generate it 

//<html><head>Welcome to the Database Sample App</head><body><p>Please choose \t 

from the f ollowing . . . </p> 
//<a href =" ./DBConnector?action=l" >Select statement l</a><a href = "./ 

DBConnector?action=2 " >Select statement 2</a> 
//</body></html> 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag .html .Head head = new com. thinairapps . tag .html . Head () ; 

head. addChild (new com . thinairapps . tag . html . Text ( "Welcome to the Database Sample 

App") ) ; 
doc. setHead (head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag . html . Paragraph para = new com. thinairapps . tag . html . Paragraph ^ 
0 ; 

para. addChild (new com.thinairapps.tag.html .Text ("Please choose from the followingKT 
...")); 

mBody . addChild (para) ; 

com. thinairapps. tag. html. Anchor anl = new com. thinairapps .tag .html .Anchor ( "Select 
statement 1", " . /DBconnector?action=l" , new com. thinairapps . tag . html . Text 
( "Query 1" ) ) ,- 

mBody .addChild (anl) ; 

mBody .addChild (new com. thinairapps . tag . html .Break () ) ; 

com. thinairapps . tag . html .Anchor an2 = new com . thinairapps . tag . html .Anchor (" Select i^' 
statement 2", " . /DBconnector?action=2 " , new com. thinairapps . tag . html . Text 
("Query 2")); 

mBody. addChild (an2) ; 

mBody . addChild (new com. thinairapps . tag . html . Break () ) ; 

doc . setBody (mBody) ; 

//render the card and then output 
out .write (doc . render ( ) .getBytes ( ) ) ; 
} 
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else 

//else, the action parameter is populated 

//Open the database connection , 
{ 

Connection con = null; 
Statement stmt = null ; 

ResultSet result = null; 

ResultSetMetaData resultmeta; 

String headerl = null; 

String header2 = null; 

//open connection to DB 

try 

{ 

//Using the Microsoft JDBC ODBC Driver 

Class . f orName ( "com.ms . jdbc . odbc . JdbcOdbcDriver" ) ; 

//here's the sun driver 

//Class . f orName ( " sun . jdbc. odbc . JdbcOdbcDriver" ) ; 

} 

catch (Exception e) 
{ 

System. out .println ( "Failed to load JDBC/ODBC driver."); 

} 

//Be sure to establish a ODBC connection with Northwind as the DSN 
String URL = " jdbc: odbc: Northwind" ; 

//there is no username or password 

String username = ""; 

String password = ""; 

try 

{ 

//try to establish connection 

con = DriverManager .getConnection (URL, username , password) ; 

//create a Statment 

stmt = con.createStatement () ; 

} 

catch (Exception e) 
{ 

System.err.println( "problems connecting to "+ URL); 

} 



String query = null; 

//Determine which select statement to use 
if (action. equals { "1" ) ) 

query = "Select CompanyName, Phone from Shippers;"; 

else 

//action equals 2 so use second SQL 

query = "SELECT DISTINCTROW TOP 10 Products . ProductName , Products .UnitPrice ^ 
FROM Products ORDER BY Product s . Unit Price DESC;"; 

try 

{ 

//execute the query 

result = stmt .executeQuery (query) ; 

//get metadata 

resultmeta = result . getMetaData () ; 

//get the first column label, the return is limited to 2 columns due to the \l 
SQL query 

headerl = resultmeta.getColumnLabel (1) ; 
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/ fqBt. the second column label 

header2 = resultmeta.getColumnLabel (2) ; 

} 

catch (Exception e) 
{ 

String eraesg = e.getMessage { ) ; 
System. err. println(emesg) ; 



//retrieve data, generate page depending on client 
if (device instanceof WAPDevice) 
{ 

//Generate result page, using the metadata above to generate the header 
columns 

//<wml><card id="result" title= "Result s " xpxtable columns= "2 " ><tr><td> 

Header</td><td>Header2</td></tr> 
//<tr><td>Details</td><td><Details2</td></tr> . . . . </table></p></card></wTnl 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( "Results" ) ; 

com. thinairapps . tag .wml . Paragraph p = new com. thinairapps . tag . wml . 

Paragraph (com. thinairapps . tag .wml . Paragraph. ALIGN_LEFT, com. ^ 

thinairapps . tag . wml . Paragraph . MODE_WRAP) ; 
p. addChild (new com. thinairapps . tag .wml .Text ( "<b>Results</b> " ) ) ; 
p.addChild (new com. thinairapps. tag. wml -BreakO ) ; 

com. thinairapps . tag. wml .Table resultTable = new com. thinairapps . tag .wml . 

Table ("Results" , com. thinairapps . tag .wml .Table .ALIGN_CENTER, 2) ; 
com. thinairapps . tag. wml .TableRow tr = new com. thinairapps . tag .wml . i^' 

TableRowO ; 

com. thinairapps. tag. wml. TableCell tcl = new com. thinairapps . tag .wml . 
TableCell 0 ; 

com. thinairapps. tag. wml. TableCell tc2 = new com. thinairapps. tag. wml . 
TableCell 0 ,- 

tcl .addChild (new com. thinairapps . tag .wml .Text (headerl) ) ; 

tc2 .addChild (new com. thinairapps .tag. wml .Text (header2) ) ; 

tr. addChild (tcl) ; 

tr. addChild (tc2) ; 

resul tTable. addChild (tr) ; 

try 

{ 

String detail 1; 
String detail2; 

//now go through the result set and render the table until result is 

while (result . next ( ) ) 
{ 

detail! = result .getString (1) ; 

detail2 = result .getString (2) ; 

tr = new com. thinairapps. tag. wml. TableRow () ; 

tcl = new com. thinairapps . tag .wml . TableCell () ; 

tc2 = new com. thinairapps . tag . wml . TableCell () ; 

tcl. addChild (new com . thinairapps . tag .wml . Text ( detail 1) ) ; 

tc2. addChild (new com . thinairapps . tag .wml . Text (detail2) ) ; 

tr. addChild (tcl) ; 

tr.addChild(tc2) ; 

resultTable. addChild (tr) ; 

} 

} 

catch (Exception e) 
{ 

String emesg = e . getMessage ( ) ; 
System. err .println (emesg) ; 

} 
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p.addChild{resultTable) ; 
card.addParagraph{p) ,- 
deck. addCard (card) ; 



//render the deck and output the result 
out .write (deck. render ( ) .getBytes () ) ; 

} 

else 



if (device instanceof HTMLDevice) 
{ 

//Below is the result page, first the HTML source , then how the 

HTML Tag libraries are used 
//<htTnl><head>Here's the result</head><body><table><tr><td> kf 

Headerl</td><td>Header2</td></tr> 
//<tr><td>detaill</td><td>detail2</td></tr>. . . .</table> 
//</body></html> 

HTMLTagDocument doc = new HTMLTagDocument ( ) 

com. thinairapps . tag .html .Head head = new com.thinairapps.tag.html. 
Head ( ) ; 

head.addChild (new com. thinairapps . tag . html .Text ( "Results" ) ) ; 

doc . setHead (head) ; 

Body mainbody = new BodyO ; 

com. thinairapps . tag . html . Paragraph mainpara = new com. thinairapps . tag 
. html . Paragraph ( ) ; 

com. thinairapps. tag. html. Table resulttable = new com . thinairapps . tag . 
html .Table (1) ; 

com. thinairapps . tag . html . TableRow tr = new com.thinairapps.tag.html. 
TableRowO ; 

com. thinairapps. tag. html. TableCell tcl = new com. thinairapps . tag . html k? 
.TableCell 0 ; 

com. thinairapps. tag. html. TableCell tc2 = new com. thinairapps . tag . html i^' 
.TableCell 0 ; 

tcl.addChild(new com.thinairapps.tag.html .Text (headerl) ) ; 

tc2 .addChild (new com. thinairapps . tag .html . Text (header2 ) ) ; 

tr.addChild(tcl) ; 

tr.addChild(tc2) ; 

resulttable. addChild (tr) ; 

try 

{ 

String detain, • 
String detail2; 

//run through the result set and render the table, until result 

is empty 
while (result .next () ) 
{ 

detail! = result . getString ( 1) ; 

detail2 = result .getString (2 ) ; 

tr = new com . thinairapps . tag .html . TableRow () ; 

tcl = new com. thinairapps . tag . html . TableCell () ; 

tc2 = new com. thinairapps . tag . html . TableCell () ; 

tcl. addChild (new com.thinairapps.tag.html .Text (detaill) ) ; 

tc2 .addChild (new com . thinairapps . tag . html .Text (detail2) ) ; 

tr. addChild (tcl) ; 

tr. addChild (tc2) ; 

resulttable. addChild{tr) ; 

} 

} 

catch (Exception e) 
{ 

String emesg = e . getMessage ( ) ; 
System. err. println(emesg) ; 

} 
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mainpara .addChild (resulttable) ; 
mainbody.addChild(mainpara) ; 
doc . setBody (mainbody) ,- 

//render the document and output the result 
out .write (doc . render ( ) .getBytes () ) ; 

} 

//close the result, stmt and con objects 

try 

{ 

result . close ( ) ; 
stmt. close 0 ; 
con. close () ; 

} 

catch (Exception e) 
{ 

System. err .println ( "Error on closing"); 
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//Core ThinAir Server API functionality- 
import com. thinairapps. platform. provider. *; 
import com. thinairapps .platform. exception. * ; 

//Core Java API 
import java.util.*; 

public class TestProviderContext extends StoreProviderContext 
{ 

public static final short RESULT = 88 8; 

// Version information 
protected static final String VERSION 
protected static String APP_NAME 
protected static final String MANUF_NAME 
protected static final String MANUF_CONT 
protected static final String BUILD 
protected static final Date APP_RELEASED 

public StoreProviderType getTypeO 
{ 

//Not used by this Provider 
return null; 

} 

i3 public StoreProviderInf o getlnfo () 
{ 

return new StoreProviderInf o ( MANUF_NAME, 
MAISIUF_CONT , 
APP_NAME , 
VERSION, 
BUILD, 

APP_RELEASED ) ; 



= "1.0"; 

= "TestProvider" ; 
= "ThinAirApps" ; 
= "www.ThinAirApps.com"; 

= new Date () ; 
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import com. thinairapps . platform. connector . * ; 
import com. thinairapps . plat form. provider . * ; 
import com . thinairapps . platform . device . * ; 

import com . thinairapps . tag . html . * ; 
import com. thinairapps . tag .wml .* ; 

import j ava . io . * ; 
import java.util.*; 
import j ava . sql . * ; 

public class TestProviderConnector implements Connector 
{ 

private ConnectorAccess myCA; 
private String connectorName ; 
private String path; 

public void init (String name. String path. Properties iniProps, ConnectorAccess ca, com. \^ 
thinairapps .platform. connector .ApplicationLog appLog) 

connectorName = name,- 
myCA = ca; 
this. path = path; 

public String [] getDevicesO 

String [] devices = { "TA_WAP" , "TA_HTML" ) ; 
return devices; 

public void handle (Properties reqProps, Device device, OutputStream out) throws ^ 
lOException 

//Find out what action the user is trying to perform 
String action = reqProps .getProperty ( "action" ) ; 
String output = null; 
String message = null; 

String sessionID = null; 

//If this is the first time entry , then action would be null. 
//We then produce a welcome screen 
if (action == null) 
{ 

/ /Detect what type of device the user has 
if (device instanceof WAPDevice) 
{ 

//Since this is a WAP device, generate WML. Below is the WML and how the WML tagi^ 
libraries are used to generate it 

//<wml><card id="main" t it le= "Welcome " ><p>Welcome to the Database Sample App<br/>i^ 

Please choose from the f ollowing . . . </br> 
//<anchor> <go href = " . /DBconnector?act ion=l " >Select statement l</go></anchor></ 
brxanchorxgo href = " . /DBconnector?action=2 " >Select statement 2</go></ 
anchor> 
// </p></card></wml> 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( "Welcome" ) ; 

com. thinairapps . tag .wml . Paragraph p = new com. thinairapps . tag . wml . Paragraph (com. k' 
thinairapps . tag . wml . Paragraph .ALIGN_LEFT, com. thinairapps . tag . wml . Paragraph . ^ 
MODE_WRAP) ; 



p . addChild (new com. thinairapps . tag . wml . Text (" <b>Welcome to the Database Sample 
App</b>") ) ; 

p . addChild (new com. thinairapps . tag . wml . Break ( ) ) ; 

p. addChild (new com. thinairapps . tag .wml . Text ( "Please choose from the following 
...")); 
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p.addChild{new com. thinairapps . tag .wml .Break <) ) ; 

com. thinairapps . tag.wml .Go go = new com. thinairapps . tag . wml . Go (". /DBconnector? )^ 

action=l", true, com . thinairapps . tag .wml .Go .METHOD_GET) ; 
com. thinairapps . tag .wml -Anchor anchor = new com. thinairapps . tag .wml .Anchor (go, newkT 

com. thinairapps . tag .wml .Text ( "Query 1" ) ) ; 

p. addChild (anchor) ; 

p.addChild(new com. thinairapps . tag . wml .Break ( ) ) ; 

go = new com. thinairapps . tag .wml . Go (". /DBconnector?action=2 " , true, Go. 
METHOD_GET) ; 

anchor = new com . thinairapps . tag . wml .Anchor (go, new com. thinairapps . tag.wml .Text ^ 
("Query 2") ) ; 

p . addChild (anchor) ; 

p . addChild (new com . thinairapps . tag .wml . Break ( ) ) ; 
card.addParagraph(p) ; 

deck. addCard (card) ; 

//render the card and then output 
out .write (deck, render ( ) .getBytes ( ) ) ,- 
} 

else 
{ 

//If it is not WML, then it can only be HTML. Below is the actual HTML and how 
the HTML tag libraries are used to generate it 

//<html><head>Welcome to the Database Sample App</head><body><p>Please choose wf 

from the f ollowing . . . </p> 
//<a href =" . /DBConnector?action=l">Select statement l</a><a href = "./ kT 

DBConnector?action=2">Select statement 2</a> 
//</body></html> 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps. tag. html. Head head = new com.thinairapps.tag.html .Head () ; 

head. addChild (new com . thinairapps . tag . html . Text ( "Welcome to the Database Sample kT 

App") ) ; 
doc . setHead (head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag .html . Paragraph para = new com. thinairapps . tag . html .Paragraph ^ 
0 ; 

para. addChild (new com. thinairapps . tag. html . Text ( "Please choose from the followingiiT 
...")); 



mBody .addChild (para) ; 

com. thinairapps . tag . html .Anchor anl = new com. thinairapps .tag. html .Anchor { "Select 
statement 1", path + "?action=l", new com. thinairapps . tag . html .Text ( "Query \£ 



mBody. addChild (anl) ,- 

mBody . addChild (new com. thinairapps . tag . html . Break () ) ; 

com. thinairapps . tag .html .Anchor an2 = new com. thinairapps . tag . html .Anchor ( "Select 
statement 2", path + "?action=2", new com. thinairapps . tag . html .Text ( "Query 
2 " ) ) ; 



mBody. addChi Id (an2) ; 

mBody .addChild (new com . thinairapps . tag . html . Break () ) ; 

doc . setBody (mBody) ; 

//render the card and then output 
out . write (doc . render ( ) .getBytes ( ) ) ; 
} 
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else 

//else, the action parameter is populated 

//get the Provider Session 

{ 

ResultSet result; 

try 

{ 

//Create a session for this user 

//The session ID will be passed back and forth in the request URL 
sessionID = myCA. createProviderSession (TestProviderContext . APP_NAME) ; 
//reqProps.putC'sid" , sessionID) ? 

initProvider (sessionID) ; 
} 

catch (Exception e) 
{ 

//catch initProvider exception here 

} 

//after init, retrieve data 

result = getResultSet (sessionID, action); 



ResultSetMetaData resulttneta; 
String headerl = null; 
String header2 = null; 

try 
{ 

//get metadata from result 
resultmeta = result .getMetaData () ; 

//get the first column label, the return is limited to 2 columns due to the SQL 

headerl = resultmeta .getColumnLabel (1) ; 

/ /get the second column label 

header2 = resultmeta . getColumnLabel { 2 ) ; 

} 

catch (Exception e) 
{ 

String emesg = e . getMessage ( ) ; 
System. err. println(emesg) ; 

} 



//retrieve data, generate page depending on client 
if (device instanceof WAPDevice) 
{ 

//Generate result page, using the metadata above to generate the header ^ 
columns 

//<wml><card id="result" title= "Results " xpxtable columns= " 2 " ><tr><td> wf 

Headerc/td><td>Header2</td></tr> 
//<tr><td>Details</td><td><Details2</td></tr> . . . . </table></p></card></wml i^- 

WMLTagDocument deck = new WMLTagDocument { ) ; 
DisplayCard card = new DisplayCard ( "Results ") ; 

com. thinairapps . tag .wml . Paragraph p = new com. thinairapps . tag .wml . 

Paragraph (com. thinairapps . tag .wml . Paragraph .ALIGN_LEFT, com. \t 

thinairapps . tag. wml . Paragraph .MOD E_WRAP) ; 
p . addChild (new com . thinairapps . tag . wml . Text (" <b>Results</b> " ) ) ; 
p . addChild (new com. thinairapps . tag . wml .Break ( ) ) ; 

com. thinairapps . tag .wml .Table resultTable = new com. thinairapps . tag .wml . 
Table { "Results" , com . thinairapps . tag . wml .Table . ALIGN_CENTER, 2) ; 
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com. thinairapps . tag . wml .TableRow tr = new com . thinairapps . tag . wml . 
TableRow ( ) ; 

com. thinairapps . tag .wml .TableCell tcl = new com . thinairapps . tag . wml . 
TableCell 0 ; 

com. thinairapps. tag. wml. TableCell tc2 = new com. thinairapps . tag .wml . \t 
TableCell 0 ; 

tcl .addChild(new com . thinairapps . tag . wml . Text (headerl) ) ; 

tc2 .addChild(new com . thinairapps . tag . wml . Text (header2 ) ) ; 

tr.addChild{tcl) ; 

tr.addChild(tc2) ; 

resultTable . addChild (tr) ; 

try 

{ 

String detaill; 
String detail2; 

//now go through the result set and render the table until result is 

empty- 
while ( result . next { ) ) 
{ 

detaill = result .getString (1) ; 

detail2 = result .getString (2) ; 

tr = new com. thinairapps . tag . wml . TableRow () ; 

tcl = new com. thinairapps. tag. wml -TableCell () ; 

tc2 = new com. thinairapps. tag. wml .TableCell () ; 

tcl . addChild (new com. thinairapps . tag . wml . Text (detaill ) ) ; 

tc2 .addChild (new com. thinairapps . tag . wml . Text (detail2 ) ) ; 

tr.addChild(tcl) ,- 

tr. addChild (tc2) ; 

resultTable. addChild (tr) ; 

} 

} 

catch (Exception e) 
{ 

String emesg = e .getMessage { ) ; 
System. err. println(emesg) ; 

} 



p. addChild (resultTable) ; 
card.addParagraph (p) ; 
deck. addCard (card) ; 

//render the deck and output the result 
out .write (deck. render ( ) .getBytes () ) ; 



else 

if (device instanceof HTMLDevice) 
{ 

//Below is the result page, first the HTML source , then how the kf 

HTML Tag libraries are used 
//<html><head>Here ' s the result</head><body><table><tr><td> ^ 

Headerl </td><td>Header2</td></tr> 
//<tr><td>detaill</td><td>detail2</td></tr> . . . .</table> 
//</body></html> 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag .html .Head head = new com.thinairapps.tag.html. 
Head ( ) ; 

head. addChild (new com. thinairapps . tag . html . Text ( "Results" ) ) ; 

doc. setHead (head) ; 

Body mainbody = new Body ( ) ; 

com. thinairapps . tag .html . Paragraph mainpara = new com. thinairapps . tagi^ 
. html . Paragraph ( ) ; 



com. thinairapps . tag . html .Table resulttable = new com. thinairapps . tag . >^ 
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html .Table (1) ; 

com. thinairapps. tag. html. TableRow tr = new com.thinairapps.tag.html. ^ 
TableRowO ; 

com. thinairapps . tag -html .TableCell tcl = new com.thinairapps.tag.html/" 
.TableCell {) ; 

com. thinairapps. tag. html. TableCell tc2 = new com. thinairapps . tag . html i^' 
.TableCell 0 ; 

tcl -addChild (new com. thinairapps. tag. html .Text (headerl) ) ; 

tc2 .addChild {new com.thinairapps.tag.html .Text (header2) ) ; 

tr. addChild (tcl) ; 

tr .addChild(tc2) ; 

resulttable. addChild (tr) ; 

try 

{ 

String detail 1; 
String detail2; 

//run through the result set and render the table, until result 

is empty- 
while (result .next ( ) ) 
{ 

detail! = result .getString (1) ; 
detail2 = result .getString (2) ; 

tr = new com. thinairapps . tag .html . TableRow () ; 

tcl = new com. thinairapps . tag.html .TableCell 0 ; 

tc2 = new com. thinairapps . tag .html .TableCell () ; 

tcl. addChild (new com. thinairapps . tag. html . Text (detain ) ) ; 

tc2 .addChild (new com. thinairapps . tag .html . Text (detail2 ) ) ; 

tr. addChild (tcl) ; 

tr. addChild {tc2) ; 

resulttable. addChild (tr) ; 

} 

} 

catch (Exception e) 
{ 

String emesg = e .getMessage ( ) ; 
System. err. println(emesg) ; 

} 

mainpara . addChild (resulttable) ; 
mainbody. addChild (mainpara) ,- 
doc . setBody (mainbody) ; 

//render the document and output the result 
out .write (doc. render ( ) .getBytes () ) ; 



private void initProv'ider (String sessionID) throws Exception 
{ 

//Retrieve the StoreProviderProxy for an existing session 
StoreProviderProxy spProxy = myCA.getStoreProvider ( sessionID) ; 

//Construct this object for pedagogical purposes only 
StoreProviderLogin login = new StoreProviderLogin(null, null, null) 
Supportedl terns supports = spProxy. connectUser (login) ; 

if (supports == null) 

throw new Exception { "Error in connectUser. Provider is unavailable"); 

} 

private ResultSet getResultSet (String sessionID, String action) 
{ 

ProviderTestResult result = null; 
try 
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{ 

//Retrieve the StoreProviderProxy for an existing session 
StoreProviderProxy spProxy = myCA.getStoreProvider (sessionID) ; 

//Construct the request object 

UserDataRequest request = new UserDataRequest ( ) ; 
request . requests = new itemRequest [1] ,- 
request . requests [0] = new ItemRequest 0 ; 

//request. requests [0] .itemType = SimpleWebProviderContext . WEB_PROVIDER_RESULT; 
request . requests [0] .bounds = new Bound[l]; 
request . requests [0] .bounds [0] = new ActionBound(action) ; 

//Contact the Provider and make the UserDataRequest 
UserData response = spProxy.getUserData (request) ; 



//Extract the data 

Storeltems items = response . responses [0] . items ; 
result = (ProviderTestResult) items . elementAt (0) ; 
} 

catch (Exception e) 
{ 

//Catch all exceptions and generate an error page 
e .printStackTrace ( ) ; 

} 

return result .getResultSet () ; 



C:\TASS\WirelessSDK\ . . \General\DatabaseProvider\src\TestProvider . java 1 

import com . thinairapps .platform . provider . * ; 

import java .util . *; 
import java.io.*; 
import j ava . sql . * ; 

public class TestProvider implements StoreProvider 
{ 

Connection con = null; 

public Supportedl terns connectUser (StoreProviderLogin login, StoreProviderContext context) 
{ 

//Create a connection object here to connect to the actual database, if we use 

//an actual login, we use the StoreProviderLogin to get the data 

//returns nothing since we don't have any thing for supported items 

//perhaps we can do read or write as supported. Normally in groupware it would be 

//messages, contacts, calendar, etc... 

Supportedltems support edit ems ; 

//open connection to DB 

try 

{ 

//Using the Microsoft JDBC ODBC Driver 

Class . f orName ( "com.ms . jdbc.odbc . JdbcOdbcDriver " ) ; 

//here's the sun driver 

/ /Class . f orName ( " sun . j dbc . odbc . JdbcOdbcDriver" ) ; 

} 

catch (Exception e) 
{ 

System. out. printlnC'Failed to load JDBC/ODBC driver."); 
return null ; 

} 

//Be sure to establish a ODBC connection with Northwind as the DSN 
String URL = "j dbc : odbc : Northwind" ,- 

//there is no username or password 

//retrieve login and password from the StoreProviderLogin Object 

String username = login. name; 

String password = login . password; 

try 

{ 

//try to establish connection 
con = DriverManager .getConnection (URL, 

} 

catch (Exception e) 



//need to return a Supportedltems object, even though we do not us€ 
//sample application 

// Support no actions 

supportedltems = new Supportedltems () ; 
String name = TestProviderContext . APP_NAME ; 
String location = "none"; 
short actions!] = new short [0] ; 

Supportedltem item = new Supportedltem (TestProviderContext . RESULT, 

, actions) ; 
supportedltems. addltem( item) ; 

return supportedltems; 



public void disconnectUser () 
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try 
{ 

con. close () ; 

} 

catch (Exception e) 
{ 

System. err. printlnC'Error on closing"); 

} 

con = null; 

//disconnectUser, disconnect from the DB, set all connections to NULL 



public UserDataActionResponse doUserDataAction (UserDataAction action) 
{ return null; 

//This is the WRITE action. So the same here.. send in SQL in the UserDataAction? or 
//maybe send in a number which correlates to a SQL internally in backend 



public UserDataLocations getLocations (UserDataLocationReguest req) 
{ return null; 

//No locations for this app. .perhaps we can specify a database for a location. . .hmmmm 



public UserData getUserData (UserDataRequest request) 

//Get the actual request, which is in the UserDataRequest ( request object) 
ItemRequest itemReq = request . requests [0] ; 

// Prepare the return object 
UserData ud = new UserData () ; 

//Create one ItemRequestResponse array entry (Why does it need to be an array?) 
ud. responses = new ItemRequestResponse [ 1 ]; 

//Now actual populate the 1st index with an ItemRequestResponse object 
ud. responses [0] = new ItemRequestResponse () ; 

//Set the request field to the itemReq (the UserDataRequest object that was passed ini^ 
ud. responses [0] . request = itemReq; 

//In the above, why do we need to store the actual itemReq, why not just use it? 

//What is the reason for the below? 
//short type = itemReq . itemType ; 

// Verify that the request is of the correct itemType 
/ /must change 

//if (type != /*SimpleWebProviderContext.WEB_PROVIDER_RESULT*/) 

// throw new RuntimeException ( "Unknown item request type: "+type) ; 

// The requested URL is wrapped in a StringBound 

//Why put it into a bound object? Unless Bound is the actual request? 

StringBound bound = (StringBound) ud . responses [ 0] . request . bounds [0 ] ; 
String action = (String) bound . getValue () ; 

//get the actual data.. the READ portion. . .wrap a SQL statement or a numeric 
//represnetation of a SQL statement in the UserDataRequest 

Statement stmt = null; 

ResultSet result = null; 

try 
{ 

//create a Statment 

stmt = con.createStatement 0 ; 

} 

catch (Exception e) 



C: \TASS\WirelessSDK\ . . \General\DatabaseProvider\src\TestProvider. java 



3 



System. err . println { "problems connecting to database"); 

} 

String query = null; 

//Determine which select statement to use 
//retrieve using the UserDataRequest object 
if (action. equals ( "1" ) ) 

query = "Select CompanyName , Phone from Shippers;"; 

else 

//action equals 2 so use second SQL 

query = "SELECT DISTINCTROW TOP 10 Products . ProductName , Products .UnitPrice FROM ^ 
Products ORDER BY Products .UnitPrice DESC;"; 

try 
{ 

//execute the query 
result = stmt . executeQuery (query) ; 

} 

catch (Exception e) 
{ 

string emesg = e . getMessage { ) ; 
System. err. println(emesg) ; 

} 



ProviderTestResult returnresult = new ProviderTestResult ( result ) ; 

//return the resultset and resultmeta data back to the connector 

// Finish loading the return object 

ud. responses [0] . items = new Storeltems () ; 

ud. responses [0] . items . addElement (returnresult) ; 

//close statement 

//try 

//{ 

//stmt .close () ; 
//} 

//catch (Exception e) 

//{ 

//} 



return ud; 
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//Core ThinAir Server API functionality 
import com. thinairapps .platform. provider . * ; 



public class ActionBound extends StringBound 
{ 

public ActionBound {String action) 
{ 

super (action, StringBound . COND_EQUALS) ; 




C : \TASS\ ■ ■ \General\DatabaseProvider\src\ProviderTestResult . java 



1 



//Core ThinAir Server API functionality 

import com. thinairapps .platform. * ; 

import com. thinairapps .platform. provider . * ; 

import j ava .util . * ; 

import j ava . sql . * ; 

public class ProviderTestResult extends Storeltem 
{ 

private ResultSet result ; 

public ProviderTestResult (ResultSet r) 
{ 

super { ) ; 
result = r; 

) 

public ResultSet getResultSet ( ) 
{ 

return result; 
} 

} 



README.txt 



wireless Forms Sample Application 
wireless SDK for ThinAir Server 



About this Sample 

The goal of this application is to provide an example of an application which 
interacts with a 3DBC-accessi bl e relational database. Forms and views are 
displayed in both html and WML, allowing the user to update and query data in 
a remote database from their wireless device. 



<appli cation naine=""> 
<database> 

<dsn></dsn> 
<1 ogi nx/1 ogi n> 
<passwo rdx/passwo rd> 
</database> 
<vi ews> 

<view name=""> 
'5 <query></query> 
S </vi ew> 

</views> 
<forms> 

<forin name=""> 

<query></query> 
<mappi ngs> 
<mapping> 

<input></input> 
<field></field> 
</mapping> 
r </mappings> 



Here is an example Application definition: 

<appli cation name="User Manager"> 
= <database> 

<dsn> jdbc : odbc : sarapl e_app</dsn> 
<1 ogi n>userl</l ogi n> 
<password>password</password> 
</database> 
<vi ews> 

<view name="users"> 

<query>SELECT login AS users, password AS pwd from users</query> 

</vi ews> 
<forms> 

<form name="New User"> 

<query>insert into users (login, password) select 'Sign', '$pwd'</query> 

<mappi ngs> 

<di spl ay> 

<i nput>userName</i nput> 
<f i el d>l gn</ f i el d> 
<type>text</type> 

</display> 
<display> 

<i nput>Password</i nput> 
<f i el d>pwd</f i el d> 
<type>password</type> 

</display> 
</mappi ngs> 
</form> 
</forms> 
</application> 
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sample.mdb DSN: "sampi e_app" 
northwin.mbd DSN: "Northwind 

NOTE: The included sample databases are only appropriate for use on 
Microsoft windows systems. 



Requi rements 

This sample requires the following SDK jars: 

* platform. jaf 

* taglib.jar 

* devices. jar 

It also requires the following jars included with the sample: 

* dotn.jar 

* xml4j.jar 

sample Files 

This sample consists of the following file tree: 

connector.ini - sample connector configuration file 

/src - Java sample code 

/bin - compiled Java sample code 



Building the Sample 



Compile the sample code using the Java compiler of your choice. The included 
MAKE script will compile the sample using the jdk, if available. 

Install the Connector classes, the connector.ini configuration file, and the 
"Applications" directory with the XML application definitions, into a 
subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 

Make sure all of the databases specifed in the XML application definitions 
are accessible, if you are using the sample MS Access databases, make 
sure the Data Source Names (dsns) are configured through the ODBC datasource 
manager, available in the Control Panel. 

The jars xml4j.jar and dom.jar must be added to your class path. Edit the file 
startserver.bat to include the following entries: 

Connectors/wi rel essForms/xml 4j . jar ; 
connectors/wi relessForms/dom. jar ; 



start the ThinAir Server. It should load wi relessFormsConnector , which should 
then in turn load all xml application definitions within its defined 
"ApplicationoefinitionDi rectory" directory. The directory defined in the 
supplied connector.ini is "<thinai rserver install di rectory>\connectors 
\wi rel essforms\appli cations" Place the xml files into that directory. 



Using the Sample 



Wait until the Thi nAi rserver has started and the wi relessFormsConnector 
has been loaded and initialized. From your wireless device or web browser, 
enter the IP address of your machine/wforms Cor whatever the value for 
ApplicationPath is set to in connector.ini above. For a machine 
with IP address 111.222.12.34 this would be: 
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README.txt 

http : //111 . 222 . 12 . 34/wf orms 

supported devices include WAP: phones, hdml phones, Palm Pilots, windows CE 
devices, desktop web browsers, and GO America/GO rim pagers, to create a pqa 
application for the Palm VII that integrates with the TninAir Server, you 
will need to understand and use "web clipping" technology from Palm, web 
clipping involves essentially creating html interfaces into your applications. 
For your convienence, an HTML file (wforms.html) has been provided for 
this purpose. To find out more about creating pqas and web clipping 
technology, visit: http://www.palmos.com/dev/tech/webclipping/ 



Last updated: 11.18.2000 
copyright 1999, 2000 ThinAirApps inc 
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/** 

* @{#)WView. java 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE kT 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

public class WView 
{ 

private String name; 

private String key; 
private String key_query; 

private String query; 

public WView (String name. String key. String key_query. String query) 

O this. key = key; 

this. query = query; 



public String getNameO 



public String getKeyO 
return key; 



1| public String getQueryO 
return query; 

} 
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* @(#)WMLResultSetDeck;. java 

* Copyright (c) 2 000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN- THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF kf 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

import com . thinairapps . tag . wtnl . * ; 
import j ava . sql . * ; 

public class WMLResultSetDeck extends WMLTagDocument 
{ 

/** 

* Returns the result in Table format 

* (Sparam resultSet is a ResultSet from the query results 
*/ 

public WMLResultSetDeck (ResultSet resultSet) throws SQLException 
{ 

^ j super ( ) ; 

ResultSetMetaData metaData = resultSet . getMetaData () ; 
int numberOf Columns = metaData .getColumnCount () ; 



//for each row first display primary key 

Card card = new Card ( "kl" , "View" ) ; 
String value = null; 

Paragraph p = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 

int keyldx = 1; 

int rowldx = 0; 

String cardName = null; 

addCard (card) ; 

p.addChild(new Bold (metaData .getColumnLabel (I) ) ) ; 
p.addChild(new Break () ) ; 
card.addChild<p) ; 

int max = 10; 

while (resultSet . next ( ) && rowldx < max ) 
{ 

cardName = "r" + rowIdx++; 
value = resultSet .getObj ect (keyldx) . toString () ; 

p . addChild (new Anchor(new Go("#" + cardName, false) , new Text (value) )) ; 

Card card2 = null; 
String label = null; 

card2 = new Card (cardName) ; 

Paragraph p2 = new Paragraph ( Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 

for (int column = 2; column <= numberOf Columns ; column++) 
{ 

label = metaData. getColumnLabel (column) + ":"; 
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value = resultSet .getObj ect (co 
p2 .addChild(new Bold (label) ) ; 
p2 .addChild(new Text (value) ) ; 
p2 .addChild(new Break () ) ; 



card2 .addChild(p2) 
addCard (card2) ; 
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/** 

* ®(i)WMLApplicationRenderer. java 

* Copyright (c) 2 000 ThinAirApps , Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE i^' 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

import com.thinairapps.tag. *; 
import com. thinairapps . tag . wml . * ; 

import java .util .Enumeration ; 
import java .util -Vector ; 
import j ava . net . URLEncoder ; 

import java. util. Properties; 

import j ava . sql . * ; 

/** 

13 This class implement the ApplicationRenderer interface. See that class for 
ir* more information on each method. 

lAiblic class WMLApplicationRenderer implements ApplicationRenderer, ApplicationConstants 
/** 

* Render all currently loaded applications in a selectable list 

* ©param apps a hashtable of Application objects 

* ©return a String with WML tags 
*/ 

public String renderApplications (java. util .Hashtable apps) 

T { 

Paragraph p = new Paragraph ( Paragraph. ALIGN_CENTER, Paragraph. MODE_NOWRAP ) ,- 

p.addChild(new TextC'Choose Application:")); 
p.addChild (new Break () ) ; 

String action = null; 

Enumeration enum = apps .elements () ; 

Application app = null; 

String url = null; 

Properties urlProps = new Properties () ; 
urlProps . put (ACTION_ARG, MENU_ACTION) ; 

while (enum.hasMoreElements ( ) ) 
{ 

app = (Application) enum. nextElement () ; 
urlProps. put (APP_ARG,app.getName () ) ; 

url = URLBuilder.buildWapUrl ("?", urlProps , true) ; 

p.addChild (new Anchor(new Go (url , false) , new Text (app. getName ()))) ; 
p.addChild (new Break {)) ; 

} 
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WMLTagDocument doc = new WMLTagDocument ( ) ; 

Card mCard = new Card ( "wf ", "Wireless Forms"); 
TnCard.addChild(p) ; 

doc. setCard(mCard) ; 

return doc . render () ; 



* Render a menu for a single Application that allows you to select WForms and WViews 

* ©paratn app an Application instance 

* ©return String with WML Tags for a menu 
*/ 

public String renderMenu (Application app) 
{ 

Paragraph p = new Paragraph (Paragraph .ALIGN_CENTER, Paragraph .MODE_NOWRAP) , • 

p.addChild(new TextC'Choose Application:")); 
p . addChild (new Break ( ) ) ; 

String action = null; 



Enumeration enum = app .get Forms () ; 

WForm form = null; 

p. addChild (new Bold (" FORMS :") ) ; 
p. addChild (new BreakO); 

String url = null; 

Properties urlProps = new Properties () ; 
urlProps ..put (ACTION_ARG, FORM_ACTION) ; 
urlProps . put (APP_ARG, app . getName ( ) ) ; 

while (enum.hasMoreElementsO ) 
{ 

form = (WForm) enum. nextElement 0 ; 
urlProps .put (ITEM_ID, form. getName 0 ) ; 

url = URLBuilder .buildWapUrl ("?", urlProps, true) ; 

p. addChild (new Anchor(new Go (url , false) , new Text (form. getName ()))) ; 
p. addChild (new BreakO); 

} 

enum = app . getviews ( ) ; 

WView view = null; 

p . addChild (new Bold ( "VIEWS : " ) ) ; 
p. addChild (new BreakO); 

urlProps. put (ACTION_ARG, VIEW_ACTION) ; 



while (enum.hasMoreElementsO) 
{ 

view = (WView) enum. nextElement () ; 

urlProps. put ( ITEM_ID , view . getName ( ) ) ; 

url = URLBuilder .bull dWapUrl ( " ? " ,urlProps , true) ; 
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p.addChild (new AnchorCnew Go (url , false ), new Text (view . getName 0 ))) ; 
p.addChild(new Break ()) ; 



p.addChild (new Break ( ) ) ; 



WMLTagDocument doc = new WMLTagDocument ( ) ; 

Card mCard = new Card( "wf "Wireless Forms"); 
mCard.addChild (p) ; 

doc. setCard(mCard) ; 

return doc. render (); 



* Render a JDBC ResultSet for a particular Application and a particular WView 

* @param app the application the WView is from 

* @param view the WView the ResultSet was generated from 

* @param resultSet the resultSet generated from a view and its SQL query 

* ©return String with WML tags with the result set from the database query 
*/ 

public String renderView (Application app, WView view, ResultSet resultSet) 
{ 

try 

return new WMLResultSetDeck (resultSet) . render ( ) ; 

} 

catch (SQLException se) 
{ 

return se . toString ( ) ; 

} 



*■ Render a particular application's form 

* ©param app the application the WForm is a part of 

* ©param form the WForm to render 

* ©return a String with the WML form 
*/ 

public String renderForm (Application app, WForm form) 
{ 

java .util . Properties props = f orm . getDisplayMap ( ) ; 

Enumeration keys = props .keys {) ; 
String key = null, label = null; 



java .util . Properties urlP = new java. util . Properties () ; 
url P. put ( "ap" , app. getName ()) ; 
url P .put ( "a" , IKSERT_ACTION) ; 
urlP . put ( " i" , form. getName ( ) ) ; 

MultiplelnputCard mic = new MultiplelnputCard (" cl ", form. getName {)) ; 



Label edinput [] li 



= new Labeledlnput [props . size 0 ] ; 
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int i = 0; 

while (keys .hasMoreElements ( ) ) 
{ 

key = (String) keys .nextElement () ; 
label = (String) props .get (key) + " : " ; 
li[i++] = new Labeledlnput (key, label) ; 
urlP.put (key, "$"+key) ; 

) 

String url = URLBuilder .buildWapUrl ( " ? " , urlP, true) ,- 
mic.buildCard (url , "Submit ", li , Go .METHOD_GET) ; 
WMLTagDocument deck = new WMLTagDocument ( ) ; 
deck.addCard(mic) ; 
return deck . render ( ) ; 



/** 

* Render a confirmation message with a link to a specific URL 

* @param app the Application the confirmation is for 

* Oparam title the title to display for the confirmation 

* oparara message the confirmation message to display 

* @param url the url to provider a link to 

* ©return String with WML tags with confirmation message 
*/ 

public String renderConf irmation (Application app. String title. String message. String 
url) 

{ 

Paragraph p = new Paragraph ( Paragraph. ALIGN_CENTER, Paragraph. MODE_WRAP) ; 
p.addChild{new Text (message) ) ; 

Properties urlProps = new Properties!); 
urlProps.put (ACTION_ARG, APP_ACTION) ; 
urlProps.put {APP_ARG,app.getName() ) ; 

p.addChild (new Anchor (URLBuilder .buildWapUrl ("?", urlProps , true) , "Ok" , new Text 
("Ok") ) ) ; 

WMLTagDocument page = new WMLTagDocument ( ) ; 

Card card = new Card ( "cl" , title) ; 
card. addChild (p) ; 
page . addCard (card) ; 

return page . render () ; 
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* @(#)WirelessFormsConnector. java 

* Copyright (c) 20 00 ThlnAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE ^ 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

//thinair platform imports 

import com . thinairapps .platform. connector . * ; 
import com. thinairapps .plat form. provider . * ; 
import com. thinairapps .plat form. exception. * ; 
import com. thinairapps .platform. device . * ; 

//standard java imports 
import java -util . * ; 
import j ava . io . * ; 



:,n* This Connector provides wireless clients with a simple 

user interface for interacting with a relational database 
Qj- other JDBC/ODBC accessible data. 

."gublic class Wireless FortnsConnector implements Connector, ApplicationConstants 

i| 

' //thB main appplication logic class which this Connector employs 
lO WirelessForms wf = null; 

//globals to hold information on jdbc drivers and application directory location 
private String DB_DRIVER = null; 
01 private String APP_DIR = null; 

/** 

* initialize the connector 
13 * ©param name of application 

I * @param path to application from URL 

* Oparam iniProps from the connector.ini file 

* ©param ca interface for Connectors to access the server 

* ©param al used for logging 
*/ 

public void init (String appName, String appPath, Properties props, ConnectorAccess ca, ^ 
com . thinairapps . platform . connector . Appl icat ionLog al ) 

{ 

//instantiate the central WirelessForms object, shared across all requests 
wf = new WirelessForms (appPath) ; 

//get the XML application definition directory from provider.ini 
if (props .getProperty ( "ApplicationDef initionDirectory" ) 1= null) 
APP_DIR = props .getProperty ( "ApplicationDef initionDirectory" ) ; 

else 

APP_DIR = DEFAULT_APP_DIR; 

//get the JDBC database driver from provider.ini 
if (props .getProperty { "DatabaseDriver" ) != null) 

DB_DRIVER = props .getProperty ( "DatabaseDriver" ) ; 

else 

DB_DRIVER = MS_DB_DRIVER; 



//attempt to initialize WirelessForms object 
try 
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( 

wf.init (APP_DIR, DB_DRIVER) ; 

} 

catch (Exception e) 
{ 

System. err .println ( "WirelessFormsConnector . init : error on WirelessForms init 

: " + e) ; 
e -printStackTrace ( ) ; 

} 



/** 

* handle an incoming request 

* ©param reqProps represents the HTTP request 

* @param device the actual wireless device instance making the request 

* @param out the OutputStream to write back the response 
*/ 

public void handle (Properties req, Device device, OutputStream out) 
{ 

//extract current action using defined variable name constant 
String action = req.getProperty (ACTION_ARG) ; 

//init object used to store output from renderering 
string output = null; 

//init the renderer superclass 
ApplicationRenderer renderer = null; 

//based on the device type, determine which subclass of 
//ApplicationRenderer to use. Since some WAP devices also 
//supports HTML, we will specifically look for WAP suport first 
if (device instanceof WAPDevice) 



//its a WAP device, so create a WML Renderer 
renderer = new WMLApplicationRenderer (); 

Ise if (device instanceof HTMLDevice) 



//its a HTML deice, so create an HTML Renderer 
renderer = new HTMLApplicationRenderer (); 



//if the action is NULL or is the default APP_ACTION 
//get the list of available applications 
if (action == null j| action . equals (APP_ACTlON) ) 
output = wf .getApplications (renderer) ; 

//the action tells the server to reload application definitions 
else if (action. equals (RELOAD_ACTION) ) 

try 
{ 

wf . init (APP_DIR, DB_DRIVER) ; 

output = wf .getApplications (renderer); 

} 

catch (Exception e) 
{ 

System. err. println ( "WirelessFormsConnector . handle : error on WirelessForms \l 

} 

} 

//retrieve and render a Menu, which display Forms and Views, for a specific 

Application 
else if (action. equals (MENU_ACTION) ) 

output = wf.getMenu ( req.getProperty (APP_ARG) , renderer); 



//retrieve and render a View (essentially a JDBC ResultSet) 
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else if (action. equals (VIEW_ACTION) ) 

output = wf .getView{req.getProperty (APP_ARG) , req.getProperty (ITEM_ID) , req. kT 
get Property (KEY) , renderer) ; 

// 

else if (action. equals (FORM_ACTION) ) 

output = wf .getForm (req.getProperty (APP_ARG) , req.getProperty (ITEM_ID) , renderer) ; 

//insert data into a table, and display a confirmation 

else if (action. equals (INSERT ACTION) ) 

{ 

output = wf . insertEntry (req .getProperty (APP_ARG) , req . getProperty (ITEM_ID) , req, 
renderer) ; 

} 

//write the output to the OutputStream via a PrintWriter 
PrintWriter ps = new PrintWriter (out ) ; 
ps.println(output) ; 
ps.flushO ; 
ps . close { ) ; 

} 

/** 

* ©return String array containing the names of all DeviceProf iles supported by this 

Connector . 

* These names are the friendly names used to uniquely identify every \^ 
DeviceProf lie . 

*/ 

public String [] getDevices () 
{ 

//This connector will specify three devices: PalmVII, any 
//HTML mini-Browser device and any WAP mini-browser device 

String[] devices = {WAPDeviceProfile. NAME, PalmVIIDeviceProfile. NAME, HTMLDeviceProfilei^ 

. NAME } ; 

return devices,- 

} 



3 
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/** 

* @(#) WirelessForms . java 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE ^ 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF \£ 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

import org.w3c -dom. * ; 
import dom . * ; 

import java.util .*; 
import j ava . sql . * ; 
import java.net.*; 



/** 

* This class contains primary application logic for the WirelessForms 

* application. 
,,..*/ 

3>ublic class WirelessForms implements ApplicationConstants 

//stores all loaded appications 
private Hashtable apps ; 

//stores the JDBC driver to use 
private static String DRIVER = null; 

private static final String DEFAULT_PARSER_NAME = "dom. wrappers . DOMParser" ; 

private static String m_appPath; 

public WirelessForms (String appPath) 
{ 

super ( ) ; 

m_appPath = appPath; 

} 

/* 

* build forms and view, store in hashtable 
*/ 

public void init (String AppDir, String DRIVER) throws Exception 
this. DRIVER = DRIVER; 

apps = new Hashtable () ; 
Application app = null; 

String[] files = new j ava . io . File (AppDir) . list () ; 

for (int i = 0; i < f iles . length ; i++) 
{ 

app = buildAppFrotnXML (AppDir + "/" + files[i]),- 
apps.put (app.getName 0 ,app) ; 

} 

} 

/** 

* loads an Application Definition from a URL and creates an Application object 

* from it using a DOM parser 
*/ 

private static Application buildAppFromXML (String uri) throws Exception 
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DOMParserWrapper parser = (DOMParserWrapper) new dom. wrappers .NonValidatingDOMParser \e 
0 ; 

Document document = parser . parse (uri ) 

String appName = ( (Element) document .getElementsByTagName ( "application" ). item(O) ) . 
getAttribute("name") ; 

/ / Get the source info 

Element dbElement = (Element ) document .getElementsByTagName ( "database" ). item (0) ,- 
String dsn = getSubNodeValue (dbElement, "dsn"); 
String login = getSubNodeValue (dbElement, "login"); 
String password = getSubNodeValue (dbElement, "password"); 

Application app = new Application(appName, dsn, login, password, m_appPath) ; 

NodeList viewElements = document . getElementsByTagName ("view"); 
Element viewElement = null; 

VfView view = null; 

String viewName,key, key_query, query; 

for (int i = 0; i < viewElements . getLength (); i++) 
{ 

viewElement = (Element ) viewElements . item (i) ; 

viewName = viewElement .getAttribute ( "name" ) ; 

key = getSubNodeValue (viewElement, "key"); 

key_query = getSubNodeValue (viewElement, " key_guery" ) ; 

query = getSubNodeValue (viewElement, "query"); 

view = new WView (viewName , key , key_query, query) ; 

app . addView (view) ; 

} 

Nodeliist formElements = document .getElementsByTagName ("form"); 
Element formElement = null; 

WPorm form = nul 1 ; 

String formName, formQuery, dinput, dField; 
Properties dProps = null; 

for (int i = 0; i < formElements .getLength (); i++) 
{ 

formElement = (Element ) formElements . item (i); 

formName = formElement .getAttribute ( "name" ) ; 

formQuery = getSubNodeValue (formElement, "query"); 

dProps = new Properties () ; 
NodeList dElements = null; 
Element dNode = null; 

Element dMap = (Element ) formElement . getElement sByTagName ( "mappings" ). item ( 0 ) ; 
dElements = dMap . getElement sByTagName ( "display ") ; 

for (int n = 0; n < dElements . getLength {) ; n++) 
{ 

dNode = (Element) dElements . item (n) ; 
dinput = getSubNodeValue (dNode, "input"); 
dField = getSubNodeValue (dNode, "field"); 
dProps. put (dField, dinput); 

} 

form = new WForm (formName, formQuery, dProps) ; 
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app.addFortn (form) ; 

} 

return app; 

} 

/** 

* gets value from a subnode of the passed element 
*/ 

private static String getSubNodeValue (Element element , String node) 
{ 

try 

{ 

return ( (Element) element .getElementsByTagName (node) .itera(O)) . getFirstChild () . \^ 
getNodeValue 0 .triraO ; 

} 

catch (Exception e) 
{ 

return null; 
} 

} 

/** 

* open a connection to the database specified by an Application 

* and store it in the Application object 
V 

public void connect (String appName) throws Exception 
{ 

Application app = (Application) apps .get (appName) ; 

app . setConnection (DatabaseTool . openConnection (app . getDSN () , DRIVER, app .getLogin () ,app. 1/ 
getPas sword () ) ) ; 

} 

/* 

* enumerate through apps 
*/ 

public String getApplications (ApplicationRenderer renderer) 
{ 

return renderer . renderApplications (apps) ; 

) 



/* 

* enumerate through forms and views and build menu 
*/ 

public String getMenu (String application, ApplicationRenderer renderer) 
{ . . 

Application app = (Application) apps . get (application) ; 
return renderer . renderMenu ( app) ; 

} 

/* 

* get view name with key value, execute query, display table output 
*/ 

public String getView (String application. String name. String key, ApplicationRenderer yr 
renderer) 

{ 

try 
{ 

Application app = (Application) apps . get (appl icat ion) ; 

if (app.getConnectionO == null || app . getConnection ( ) . isClosed ( ) ) 
connect (application) ; 

WView view = app.getView (name) ; 

ResultSet resultSet = DatabaseTool . executeSelect (view.getQueryO , app. getConnection \^ 
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0 ) ; 

String out = renderer.renderView(app,view, resultSet) ,- 

resultSet . close ( ) ; 

return out, 

catch (Exception se) 
{ 

return se . toString ( ) ; 

} 

} 

/* 

* build input form from form object 
*/ 

public String getForm (String application. String name, ApplicationRenderer renderer) 
{ 

Application app = (Application) apps .get (application) ; 
WForm form = app.getForTti (name) ; 
return renderer. renderForm (app, form) ; 

} 

/* 

* replace vars in insert string, execute insert query, display result 
*/ 

public String insertEntry (String application, String name, Properties props, ^ 
ApplicationRenderer renderer) 

{ 

Application app = (Application) apps .get (application) , • 

System. out -println { "got app: " + app . getName ( ) ) ; 
WForm form = app. getForm (name) ; 

System. out .println ( "got form: " + form. getName ()) ; 

String url = "/?a=f&i=" + URLEncoder . encode (form. getName () ) + "&:ap=" + URLEncoder. \l 
encode (app . getName () ) ; 

try 
{ 

if (app . getConnection ( ) == null || app . getConnection ( ) . isClosed ( ) ) 
connect (application) ; 

Enumeration enum = props . keys () ,- 
String key = null, value = null; 

String query = f orm . getQuery ( ) ; 

System.out .print In ("query: " + query); 

while (enum. hasMoreElements 0 ) 
{ 

key = (String) enum . nextElement () ; 
value = props .getProperty (key) ; 
System.out .println (key + "=" + value); 
query = substitute (query, "$" + key, value) ; 
System.out .println ( "updated query: " + query); 

} 

DatabaseXool . executelnsert (query , app. getConnection ( ) ) ; 

return renderer . renderConf irmation (app, "Success ", "Your data was successfully t<r 
submitted. ", url) ; 

} 

catch (Exception se) 
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{ 

return renderer . renderConf irmation (app, "Error" , "There was an error submitting ^ 
your query: " + se .getMessage ( ) , url) ; 

} 

} 

/** 

* basic utility app for doing a String substitute 
*/ 

private static String substitute (String s, String old, String replace) 



int last, first = 0 ; 
String foo,bar; 

StringBuffer out = new StringBuf f er ( ) ; 

while (s . indexOf (old, first) > 0) 
{ 

last = s . indexOf (old, first) ; 
foo = s . substring (0 , last) ; 

bar = s . substring (last+old. length 0 , s . length ()) ; 

out . append ( foo) ; 

out .append (replace) ; 

out . append (bar) ; 

s = out . toString ( ) ; 

out = new StringBuf fer () ; 

first = f oo. length () +replace. length 0 ; 

} 

return s ; 
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* @(#)HTMLResultSetTable. java 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE wf 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF kf 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

import com. thinairapps . tag . html . * ; 
import j ava . sql . * ; 

/** 

* An HTML Tag Lib widget for rendering a JDBC ResultSet in a simple format 
V 

public class HTMLResultSetTable extends Table 
{ 

* Returns the result in Table format 

* ©pararn resultSet is a ResultSet from the query results 

* @parma borderSize is a int defining the bordersize of the Table 
*/ 

public HTMLResultSetTable (ResultSet resultSet, int borderSize) throws SQLException 
{ 

super (borderSize) ; 
TableRow tr = new TableRowO ; 
TableCell cell = null; 

ResultSetMetaData metaData = resultSet . getMetaData () ; 

int nuraberOf Columns = metaData. getColumnCount () ; 

for (int column = 0; column < numberOf Columns ; column++) 
{ 

cell = new TableCell () ; 

cell .addChild (new Bold (metaData .getColumnLabel (column+1) ) ) ; 
tr.addChild(cell) ; 

} 

addChild (tr) ; 

while (resultSet .next 0 ) 
{ 

tr = new TableRow ( ) ; 

for (int i = 1; i <= numberOf Columns ; i++) 
{ 

cell = new TableCell () ; 

cell .addChild (new Text (resultSet .getObject (i) . toString ( ) ) ) ; 
tr.addChild(cell) ; 

} 

addChild (tr) ; 

} 

} 
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* @ ( # ) WForm . j ava 

* Copyright (c) 20 00 ThinAirApps , Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE ^ 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

import java. util. Properties; 
/** 

* The basic WirelessFortn form object. Instances of this class are built 

* automatically from the XML Application Definition. 
*/ 

public class WForm 
{ 

private String name; 

private String query; 

private Properties displayMap; 

/** 

* @param name the displayable form name 

* ©param query the insert query to use for submitting the form data 

* @param displayMap a prop mapping form field variables to displayable labels 
*/ 

public WForm (String name. String query. Properties displayMap) 

this. name = name; 

this. query = query; 

this .displayMap = displayMap; 



public String getName ( ) 



public String getQueryO 
return query; 



public Properties getDisplayMap ( ) 
return displayMap; 
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* @ (#) HTMLApplicationRenderer .java 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF ^ 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 



//Thinair Tag Library 

import com. thinairapps . tag . * ; 

import com . thinairapps . tag . html . * ; 

//Java Utilities 
import java .util .Enumeration ; 
import java .util .Vector; 
import j ava . net .URLEncoder ; 

//Java SQL library 
import j ava . sql . * ; 

* This class implement the ApplicationRenderer interface. See that class for 

* more information on each method. 
*/ 

public class HTMLApplicationRenderer implements ApplicationRenderer, ApplicationConstants 
{ 

/** 

* Render all currently loaded applications in a selectable list 

* ©param apps a hashtable of Application objects 

* ©return a String with HTML tags 
*/ 

public String renderApplications ( j ava . util .Hashtable apps) 
{ 

try 

Paragraph body = new Paragraph () ; 

String action = null; 

Enumeration enum = apps . elements () ; 

Application app = null; 

// body. addChild (new Text (" <b>Applicat ions : </b><BR>" )) ; 

com. thinairapps . tag .html . Form hForm = new com. thinairapps . tag . html . Form \^ 
("fl", "", "GET") ; 

Select select = new Select ( "ap" ) ; 
select . addAt tribute ( "size" , " 3 " ) ; 

while (enum.hasMoreElements ( ) ) 
{ 

app = (Application) enum. nextElement () ; 

//action = "?a=m&ap=" + URLEncoder . encode (app . getName ()) ; 
select .addOption(app.getName () , false) ; 

} 
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hForm.addChild( select) ; 
hForm.addChild(new Break {) ) ; 

hForm.addChild{new Submi t Butt on ( "Launch" ) ) ; 
hForm.addChild {new Anchor ( "Refresh" , "?a=r") ) 
hForm.addChild(new Hiddenlnput ( "a" , "m") ) ; 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
Head head = new Head ( ) ; 

head. addChild (new Title ( "Wireless Forms") ); 
doc . setHead (head) ,- 

Body ttiBody = new Body ( ) ; 

mBody .addChild (new Bold ("Select an application:" 
mBody. addChild (new Break ()) ; 
mBody. addChild (hForm) ; 

doc . setBody (mBody) ; 

return doc . render {) ; 



catch (InvalidTagExcepti( 
{ 

return null; 



* Render a menu for a single Application that allows you to select WForms and WVie' 

* ©param app an Application instance 

* ©return String with HTML Tags for a menu 
*/ 

public String renderMenu (Application app) 



Paragraph body = new Paragraph () ; 

Enumeration views = app .getviews ( ) ; 
WView view = null; 
String action = null; 

com. thinairapps . tag . html . Form viewForm = new com. thinairapps . tag .html . Form 
( "views" , " " , "GET") ; 

viewForm. addChild (new Text ( "Views : ")); 
viewForm. addChild (new Hiddenlnput ("a","v")); 
viewForm. addChild (new Hiddenlnput ( "ap" , app . getName ( ) ) ) ; 
Select viewSelect = new Select ("i"); 

while (views . hasMoreElements { ) ) 
{ 

view = (WView) views . nextElement () ; 
viewSelect -addOption (view . getName { ) , false) ; 

} 

viewForm. addChild (viewSelect) ; 

viewForm. addChild (new SubmitButton ("Go")); 
body .addChild (viewForm) ; 
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body .addChildCnew BreakO); 

Enumeration forms = app .get Forms () ; 
WForm form = null ; 

// 

com. thinairapps .tag. html .Form formForm = new com. thinairapps . tag . html . Form 
{ "forms" , " " , "GET" ) ; 

formForm. addChi Id (new Text ("Forms: ")); 

formForm. addChi Id (new Hiddenlnput ("a","f")); 

formForm. addChi Id (new Hiddenlnput ( "ap" , app.getName ( ) ) ) ; 

Select formSelect = new Select ("i"); 

while (forms. hasMoreElements 0 ) 
{ 

form = (WForm> forms .nextElement () ; 
formSelect .addOpt ion (f orm.getName () , false) ,- 
} 

formForm. addChild (formSelect) ; 

formForm. addChild (new SubmitButton ("Go")); 
body .addChild (formForm) ; 



HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
Head head = new HeadO ; 

head. addChild (new Title (app .getNarae ())) ; 
doc. setHead (head) ; 

Body mBody = new Body ( ) ; 
mBody .addChild (body) ; 

doc . setBody (mBody) ; 

return doc . render () ; 

} 

catch (InvalidTagException e) 
{ 

return null; 

} 



* Render a JDBC ResultSet for a particular Application and a particular WView 

* Oparam app the application the WView is from 

* ©param view the WView the ResultSet was generated from 

* Oparam resultSet the resultSet generated from a view and its SQL query 

* ©return String with HTML tags with the result set from the database query 
*/ 

public String renderView (Application app, WView view, ResultSet resultSet) 
{ 

try 
{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
Head head = new Head ( ) ; 

head. addChild (new Title (view.getName () ) ) ; 
doc . setHead (head) ; 



Body body = 



new BodyO ; 
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body .addChild(new Text("<font size=\"l\" f ace=\ "geneva\ " >" ) ) ; 

Table table = new HTMLResultSetTable (resultSet, 1); 

body. addChild (table) ; 

body .addChild{new Break () ) ; 

body -addChild (new HorizontalRule () ) ; 

String main = "?a=m&ap=" + URLEncoder. encode (app. get Name ()) ,- 
body . addChild (new Anchor ( " " , main, new Text ( " [ menu ]"))); 

body. addChild (new Text ( " </f ont> " } ) ; 

doc . setBody (body) ; 
return doc . render ( ) ; 

catch (SQLExcept ion se) 

return se . toString { ) ; 
catch (InvalidTagException se) 

return se . toString ( ) ; 



* Render a particular application's form 

* Oparam app the application the WForm is a part of 

* ©param form the WForm to render 

* ©return a String with the HTML form 
*/ 

public String renderForm (Application app, WForm form) 
{ 

try 
{ 

java.util. Properties props = f orm.getDisplayMap () ; 
//build an HTML Form Tag object to render the WForm 

com. thinairapps . tag. html . Form hForm = new com. thinairapps . tag .html . Form (" insert ", i^' 
app.getWFormsURLO , "POST") ; 

Enumeration keys = props . keys () ; 
String key = null; 

while (keys .hasMoreElements ( ) ) 
{ 

key = (String) keys .nextElement 0 ; 
hForm. addChild (new NonBreakingSpace (4 ) ) ; 

hForm. addChild (new Text("<b>" + (String)props .get (key) + " : </b>  " ) ) ; 
hForm. addChild (new TextField (key) ) ; 
hForm. addChild (new Break ()) ; 

} 

hForm. addChild (new Break ()) ; 

hForm. addFormElement (new Hiddenlnput (ACTION_ARG, INSERT_ACTION) ) ; 
hForm. addFormElement (new Hiddenlnput (APP_ARG, app. getName ( ) ) ) ; 
hForm. addFormElement (new Hiddenlnput (ITEM_ID, form.getWame ( ) ) ) ; 

Center center = new Center () ; 
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center . addChild (new SubmitButton ( "Submit " ) ) ; 
center. addChild (new Input ( "Reset" , "Reset" , "Reset" ) ) ; 

hForm. addChild (center) ,- 

HTMLTagDocument page = new HTMLTagDocument ( ) ; 
Head head = new Head ( ) ; 

head. addChild (new Title ( form. getName ())) ; 
page . setHead (head) ; 

Body body = new Body ( ) ; 
body. addChild (hForm) ; 
page . setBody (body) ; 

return page . render ( ) ; 

} 

catch (InvalidTagException ite) 
{ 

return ite . toString () ; 

} 

} 

/** 

* Render a confirmation message with a link to a specific URL 

* ©param app the Application the confirmation is for 

* csparam title the title to display for the confirmation 

* ©param message the confirmation message to display 

* ©param url the url to provider a link to 

* ©return String with HTML tags with confirmation message 
*/ 

public String renderConf irmation (Application app. String title. String message. String \e 
url) 

{ 

try 
{ 

Center center = new Center () ; 

center . addChild (new HorizontalRule ( ) ) ; 

center .addChild (new Text (message) ) ; 

center .addChild (new HorizontalRule () ) ; 

string main = "?a=m&ap=" + URLEncoder . encode (app . getName ()) ; 
center. addChild (new Anchor ( "Ok" , main) ) ; 



HTMLTagDocument page = new HTMLTagDocument ( ) ; 

Head head = new Head ( ) ; 

head. addChild (new Title ( title) ) ; 

page . setHead (head) ; 

Body body = new Body ( ) ; 
body . addChild (center) ; 
page . setBody (body) ; 

return page . render ( ) ,- 

} 

catch ( InvalidTagException e) 
{ 

return e . toString () ; 

} 
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* @(#)DatabaseTool . java 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE ^ 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

import j. 
/** 
*/ 

public class DatabaseTool 



ility class that wraps JDBC querying logic 



/** 

* Open a JDBC connection for a particular DSN, username, and password 
*/ 

public static Connection openConnection (String url , String driverName , String ■ 
passwd) throws SQLException, ClassNotFoundException 



Class . forName (driverName) ; 
return DriverManager . getCoi 



execute an SQL query fo: 



public static ResultSet 
SQLException 



n(url, user, passwd) ; 



Select (String query, Connection connection) throws 



Statement statement = connection . createStatement () ; 
return statement . executeQuery (query) ; 



execute an SQL Insert query for the given connection 

ert (String query, Connecti< 



public static boolean 
SQLException 



connection. createStatement () ; 
(query) ; 



ion) throws 



execute a named stored procedun 



iteStoredProcedure (String sp, Obj e 



: connection. createStatement 0 ; 



StringBuffer query = new StringBuf f er ( ) ; 
query. append ("EXECUTE " + sp + " "); 
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for (int i = 0 ; i < params . length ; 

if (params [i] [1] instanceof String) 

query. append ( "@" + params [i] [0] + " = '" + params[i] [1] + "', " ) ; 
else if (params [i] [1] instanceof Integer) 

query, append ( "@" + paratnsEi] [0] + " = " + ( (Integer) params [i] [1]). 
intValue ( ) + " , " ) ; 
else if (params [i] [1] instanceof Double) 

query, append ( "@" + params[i][0] + " = " + ( (Double) params [ i] [1] ) . 
doubleValue () + ", ") ; 
else if (params [i] [1] instanceof j ava . util . Date ) 

query. append ("®" + params[i][0] + " = convert (datetime " + ((java.util. ^ 
Date) params [i] [1] ). toLocaleString 0 + "'), "); 



String command = query . toSt ring () ; 

command = command. substring (0 , command . length () -2 ) ; 

System. out .println ( "executing stored procedure: " + command); 

resultSet = statement . executeQuery (command) ; 

resultSet .close ( ) ; 
statement . close () ; 

// closeO; Need to copy the metaData, bug in jdbc:odbc driver, 
return true; 

} 

catch (SQLException ex) 
{ 

System . err . println (ex) ; 
return false; 

} 

} 

/** 

* closed the passed connectoin 
*/ 

public static void closeConnection (Connection connection) throws SQLException 
connection . close ( ) ; 
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/** 

* ® {#) ApplicationConstants. java 

* Copyright (c) 2 00 0 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE >^ 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

public interface ApplicationConstants 
{ 

//Its important to define short variable names for use in content and URLs 
public final static String ACTION_ARG = "a"; 
public final static String APP_ARG = "ap"; 

public final static String RELOAD_ACTION = "re- 
public final static String APP_ACTION = "a"; 
public final static String MENU_ACTION = ' 
public final static String VIEW_ACTION = ' 
public final static String FORM_ACTION = ' 
public final static String INSERT_ACTION = "i"; 
public final static String UPDATE_ACTION = "u"; 

public final static String KEY = "k" ; 
lU public final static String ITEM_ID = "i"; 

//some default values for use in initialization 

public final static String DEFAULT_APP_DIR = "Connectors\\WirelessForms\\apps' 

\U public final static String SUN_DB_DRIVER = "sun . jdbc . odbc . JdbcOdbcDriver " ; 

public final static String MS_DB_DRIVER = •' com. ms . jdbc . odbc . JdbcOdbcDriver " ; 



} 
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/** 

* @(#) Application. java 

* Copyright (c) 2 00 0 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE ^ 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF ^ 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 

* This class is the Java representation of the XML DTD used by 

* the Application Definitions Documents. The server parses the 

* XML document to create an instanceof this class per application. 

*/ 

import java.util .Hashtable; 
import j ava.util. Enumeration; 

import j ava . sql . * ; 

public class Application 
{ 

//the application name 
private String ra_name; 

!□ //the Data Source Name and login and password for the DSN 
private String ra_dsn; 
private String m_login; 
private String m_password; 
private String m_wforrasURL; 

//the store for all forms defined within an applicatoin 
private Hashtable forms; 

//the store for all views defined within an application 
private Hashtable views; 

//the JDBC Connection object used by each Application 
private Connection conn; 

* @param name the application name 

* ©param dsn the data source name 

* ©param login an authorized username for the DSN 

* ©param password a corresponding password for the login 
*/ 

public Application (String name. String dsn. String login. String password. String 
wf ormsURL) 

{ 

m_name = name; 
m_dsn = dsn; 
m_login = login; 
m_pas sword = password; 
m_wformsURL = wformsURL; 

forms = new Hashtable {); 
views = new Hashtable () ; 

} 

* Set and store a JDBC Connection object within an Application instance 

* @param conn a JDBC Connection object 
*/ 

public void setConnection (Connection conn) 
{ 
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* Return the current stored JDBC Connection 

* ©return a JDBC Connection instance 
*/ 

public Connection getConnection () 



public String getName ( ) 
return m_natne; 

public String getDSN{) 
return m_dsn; 

public String getLogin ( ) 
return m_login; 

public String getPassword ( ) 
return m_password; 

public String getWFormsURL ( ) 
return m_wf ormstJRL; 

public void addForm (WForm form) 

forms. put ( form. getName () , form); 

public WForm getPorm (String name) 
return (WForm) forms .get (name) ; 

public Enumeration getFormsO 
return f orms . elements () ; 

public void addview (WView view) 

views. put (view. getName 0 , view); 

public WView getview (String name) 
return (WView) views .get (name) ; 

public Enumeration getviews ( ) 
return views . elements () ; 
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/** 

* @ (#) ApplicationRenderer . java 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE i^- 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF vf 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 

import java . sql .ResultSet ; 
/** 

* Interface used to build renderers for different markup languages and device types 
V 

public interface ApplicationRenderer 



* Render all currently loaded applications in a selectable list 

* @param apps a hashtable of Application objects 

public abstract String renderApplications ( j ava . util . Hashtable apps) ; 
/** 

* Render a menu for a single Application that allows you to select WForms and WViews 

* ©param app an Application instance 
*/ 

public abstract String renderMenu (Application app) ; 
/** 

* Render a JDBC ResultSet for a particular Application and a particular WView 

* ®param app the application the WView is from 

* ©param view the WView the ResultSet was generated from 

* ©param resultSet the resultSet generated from a view and its SQL query 
*/ 

public abstract String renderView (Application app, WView view, ResultSet resultSet) ; 
/** 

* Render a particular application's form 

* ©param app the application the WForm is a part of 

* ©param form the WForm to render 
*/ 

public abstract String renderForm (Application app, WForm form) ; 
/** 

* Render a confirmation message with a link to a specific URL 

* ©param app the Application the confirmation is for 

* ©param title the title to display for the confirmation 

* ©param message the confirmation message to display 

* ©param url the url to provider a link to 
*/ 

public abstract String renderConf irmation (Application app. String title. String mess; 
, String url) ; 



README . txt 



Tic Tac Toe sample Connector 
wireless SDK for ThinAir Server 



About this Sample 



This sample connector demonstrates a simple game that can be implemented using 
the SDK. The tic-tac-toe game is always between the user and the connector 
logic. Alternating games have alternating players starting. All HTML and WML 
devices are supported by this connector. 

This connector also makes use of session objects. For more information on using 
sessions, see the SessionManagement sample connector in this directory and the 
corresponding ThinAir server API documentation. 



Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

* devices. jar 

This sample does not require any other external APIs. 



sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file 
TicTacToeConnector. jar - compiled Java code 

/src - java source files - profil econnector. java and profileData. java 



Building the Sample 



compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 

in order to display the images, the GIF files must be placed into a 
"tictactoeconnector" directory under htdocs in the ThinAi rserver directory. 
Ci e : /prog ram f i 1 es/thi nai rapps/thi nai rserver/htdocs/ti ctactoeconnector) 

start the ThinAir Server, it will load the sample code and begin executing it. 



using the sample 

wait until the Thi nAi rserver has started and the Tic Tac Toe Conr 
loaded and initialized. From your html or wml device, enter the IP address 
listed as the value for Appl i cati onPath in connector.ini (your Thi nAi rserver 
address), followed by /sampl es/ti ctactoe . For a machine with IP address 
111.222.12.34 this would be: 
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README.txt 

http : //111 . 222 . 12 . 34/sanipl es/ti ctactoe 
Follow the on-screen instructions. 



Last updated: 11.13.2000 
copyright 1999, 2000 ThinAirApps inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com . thinairapps . platform. connector . * ; 
import com . thinairapps . platform. device . * ; 
import com. thinairapps .platform. exception. * ; 

//rendering packages used to build markup 
import com. thinairapps . tag .* ; 
import com. thinairapps . tag .html . * ; 
import com. thinairapps . tag .wml .* ; 

//Core Java API 
import java.util . * ; 



/** 

* This sample Connector demonstrates a simple interactive application that can be created 

using the 

* ThinAir API. The Connector plays Tic Tac Toe against the user, and works on all HTML and 

WML 

* devices. The TicTacToeBoard class, contained in TicTacToeBoard. java, contains all the 

logic for 

* the board itself, and the game rules. The main class, TicTacToeConnector, contains the ^ 

logic for 

,. * playing strategy, the game flow, and the screen display. 

public class TicTacToeConnector implements Connector { 

//The friendly name of this sample app 
String appName ,- 

String path 
Properties props ,- 

//Our access point to the services of ThinAir Server 
ConnectorAccess access; 

//points to the directory for images 

private final static String IMAGE_PATH = " /docs/tictactoeConnector/ " ; 
Integer GameState; 

final Integer IN_PROGRESS = new Integer (1); 
final Integer USER_WON = new Integer (2) ; 
final Integer CONNECTOR_WON = new Integer (3),- 
final Integer TIE_GAME = new Integer (4) ; 



/**init() is called by the ThinAirServer when the Connector is loaded. It provides the 
Connector 

* with resources it needs to interact with the ThinAirServer. 

* @param applicationName is a String derived from connector.ini. We don't need this fori^ 

this sample. 

* ©param applicationPath is a String dervid from connector.ini. We don't need this for 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned ir? 

connector-specific properties. 

* We don't need this parameter in this sample. 

* ©param connectorAccess is our access point to the services provided by ThinAir Server ^ 

We don ' t need 

* this for this sample. 

* ©param ApplicationLog is used for Logging. It is not used in this sample 
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*/ 

public void init (String applicationName , String applicationPath, Properties 
connectorProps , 

ConnectorAccess connectorAccess , ApplicationLog al) 

appName = applicationName; 
path = applicationPath; 
props = connectorProps ; 
access = connectorAccess; 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a \^ 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used \^ 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer \/ 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getFame { ) method. 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide . 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports. 

*/ 

public String [] getDevicesO 
{ 

String deviceTypes [] = {"TA_HTML", "TA_WAP"}; 
return deviceTypes; 



/**The handle method implements the core logic of a Connector. It takes an incoming 
request from a 

* particular device, and returns an appropriate response. This method is called wheneveri^ 

the server 

* receives a request from a type of device that the Connector indicates it supports, kT 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 

* Oparam props a set of name value pairs corresponding to the HTTP request parameters 

from the device . 

* ©param device a Device object created in the image of the actual device making this 

request . 

* ©param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle ( Properties props, Device device, OutputStream out) throws lOException ^ 



String resultString ; 
this. props = props; 

//we name the sessionID param "sid" 

String sessionID = props .getProperty (" sid" ) ; 
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//the cache for this session 
Hashtable cache = null ; 

TicTacToeBoard theBoard = null; 
Integer GameState = null; 

char StartingPlayer, SecondPlayer ; 

//if this is the user's first hit, they will not yet have a session 
if (sessionlD == null) 

//so create one for them 

sessionlD = access . createSession () ; 



try 

//get the cache for this session... 

cache = access . getSessionCache ( sessionlD) ; 

catch (NoSuchSessionException e) 

//do nothing 



.f (cache == null) 

// create a new board 
theBoard = new TicTacToeBoard ( ) ; 
theBoard . init ( ) ; 
GameState = IN_PROGRESS; 

;lse if (cache. get ("board") == null) 

// create a new board 
theBoard = new TicTacToeBoard { ) ; 
theBoard. init 0 ; 
GameState = IN_PROGRESS; 



theBoard = (TicTacToeBoard) cache .get ( "board" ) ; 
GameState = (Integer) cache. get ( "GameState" ) ; 



playTurn (sessionlD, theBoard); 
cache. put ( "board" , theBoard); 
try { 

// determine which device is contacting the Connector and use a different 
// rendering class to generate output 
if (device instanceof HTMLDevice) 

resultString = HTMLDisplayScreen (sessionlD, theBoard) ; 

else if (device instanceof PalmVIIDevice) 

resultString = HTMLDisplayScreen (sessionlD, theBoard); 

else if (device instanceof WAPDevice) 

resultString = WMLDisplayScreen ( sessionlD, theBoard); 

else if (device instanceof UPWAPDevice) 

resultString = WMLDisplayScreen ( sessionlD, theBoard); 

else if (device instanceof GoWebRIMDevice) 
resultString = WMLDisplayScreen (sessionlD, theBoard); 



else 

resultString = "ERROR: Device "+device .getClass () +" not supported. 
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} catch (Exception e) { 
e .printStackTrace ( ) ; 

resultString = "ERROR: "+e . getMessage ( ) ; 

} 

out .write (resultString .getBytes ( ) ) ; 



/** 

* MakeMoveO decides on the next move for the computer to make, and changes the board to 

* reflect that move. 

* ©param theBoard the current state of the board 
*/ 

private void makeMove (TicTacToeBoard theBoard) 
{ 

Random randGen = new Random ( ) ; 
int randCell, randRow, randCol; 

int rowCount, colCount; 

//look for a winning move. . . 

for (rowCount = 0; rowCount < theBoard . NUM_ROWS ; rowCount++) { 

for (colCount = 0; colCount < theBoard. NUM_COLS; colCount++) { 
if ( theBoard . emptyAt ( rowCount , colCount)) { 

theBoard.placePiece( 'O' , rowCount, colCount); 
if (theBoard . playerWon ( ' O ' } ) { 

return ; 
} else { 

theBoard. placePiece( theBoard. EMPTY SPACE, rowCount, colCount); 

} 

} 

} 



//Barring that, block user from any winning moves.. 

for (rowCount = 0; rowCount < theBoard . NUM_ROWS ; rowCount ++) { 

for (colCount = 0; colCount < theBoard . NUM_COLS ; colCount++) { 
if (theBoard. emptyAt (rowCount, colCount)) { 

theBoard . placePiece ( ' X ' , rowCount , colCount ) ; 
if (theBoard.playerWon( 'X' ) ) { 

theBoard . placePiece ( ' O ' , rowCount , colCount ) ; 
return; 
} else { 

theBoard. placePiece (theBoard. EMPTY SPACE, rowCount, colCount); 

} 

} 

} 

} 



//Otherwise, enter piece in a randomly- chosen cell (of the ones that haven't been 
//filled already 
do { 

randCell = Math. abs (randGen. nextint () % (theBoard .NUM_COLS * theBoard . NUM_ROWS )) ; 
randRow = randCell / theBoard. NUM_ROWS ; 
randCol = randCell % theBoard. NUM COLS ; 

} 

while (! theBoard. emptyAt (randRow, randCol)); 
theBoard.placePiece( '0' , randRow, randCol); 
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/** 

* HTMLDisplayBoard ( ) returns the HTML version of the board in its current state. 

* (Sparam sessionID the current session ID 

* ©param theBoard the current state of the board 

* ©param GameOver whether or not the game is over and further clicking should be 

* disabled 

* ©return an HTML table, containing a graphical representation of the board 
*/ 

public com.thinairapps.tag.html .Table HTMLDisplayBoard (String sessionID, TicTacToeBoard ^ 
theBoard, 

boolean GameOver) { 

com. thinairapps.tag.html. Table TTTTable = new com. thinairapps . tag .html .Table (1) ; 
com. thinairapps . tag. html .TableCell 

Cell[] [] = new com. thinairapps .tag .html .TableCell [theBoard. NUM_ROWS] [theBoard. 
NUM_COLS] ; 
com. thinairapps . tag. html .TableRow 

Row[] = new com. thinairapps . tag. html . TableRow [theBoard. Kr[JM_ROWS] ; 

int rowCount , colCount; 
char curPiece; 

for (rowCount = 0; rowCount < theBoard . NUM_ROWS ; rowCount++) { 

Row [rowCount] = new com. thinairapps . tag .html . TableRow () ; 
TTTTable .addChild (Row [rowCount] ) ; 

for (colCount = 0; colCount < theBoard . NUM_COLS ; colCount++) { 

Cell [rowCount] [col Count] = new com. thinairapps . tag .html . TableCell () ; 
Row [rowCount] . addChild (Cell [rowCount] [colCount] ) ; 



if ( theBoard. emptyAt (rowCount, colCount)) { 
if (GameOver) { 

Cell [rowCount] [colCount] .addChild 

(new com. thinairapps. tag. html. Image (IMAGE_PATH + "ttt-blank. li" 
gif ") ) ; 

} else { 

Cell [rowCount] [colCount] .addChild 

(new Hyperlinkedlmage (path + "?row=" + Integer . toString 
(rowCount) + 

"&;Col=" + Integer. toString (colCount) + "SEsid=" + sessionID, 
IMAGE_PATH + " ttt-blank. gif •)) ; 

} else { 

curPiece = theBoard. pieceOccupying (rowCount , colCount); 
if (curPiece == 'X' ) { 

Cell [rowCount] [colCount] .addChild 

(new com. thinairapps. tag. html . Image (IMAGE_PATH + "ttt-x.gif " ) ) ; 
} else if (curPiece == 'O') { 

Cell [rowCount] [colCount] .addChild 

(new com. thinairapps. tag. html . Image (imGE_PATH + " ttt -o . gif " ) ) ; 

} 

} 

) 

} 

return TTTTable; 
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* This method renders an HTML page showing the board in its current state, 

the title, 

* and other explanatory information 

* ©return the rendered HTML page. 
*/ 

private String HTMLDisplayScreen (String sessionID, TicTacToeBoard theBoard) 
{ 

String resultString ; 
Body body = new BodyO ; 

HTMLTagDocument HTMLDoc = new HTMLTagDocument ( ) ,- 
Title theTitle = new Title ("Play Tic Tac Toe 1 " ) ; 



try 
{ 

//get the cache for this session. . . 
cache = access .getSessionCache (sessionID) ; 
} catch (NoSuchSessionException e) { } 

Character SecondPlayer = (Character) cache. get ( "SecondPlayer") ; 
Integer GameState = (Integer) cache. get { "GameState" ) ,- 

boolean GameOver = (GameState == USER_WON | | GameState == CONNECTOR_WON | | GameState ^ 
== TIE_GAME) ; 



/ /set the background color 

body .addAttribute ( "bgcolor" , "#f f f f f f " ) ; 

//add a title 

body .addChild (new com. thinairapps . tag .html . Bold ( "Play a game of Tic Tac Toe")),- 
body. addChild (new HorizontalRule ( ) ) ; 

body. addChild (HTMLDisplayBoard( sessionID, theBoard, GameOver)) ; 

if (GameState == USER_WON) { 

body . addChild (new com. thinairapps . tag .html . Bold ( "You winl " ) ) ,- 
} else if (GameState == CONNECTOR_W0N) { 

body. addChild (new com. thinairapps . tag -html . Bold( " I win! " ) ) ; 
} else if (GameState == TIE_GAME) { 

body. addChild (new com. thinairapps . tag . html . Bold {" It ' s a tie! ")); 

} 

body. addChild (new com . thinairapps . tag . html . Text ( "Play a " ) ) ,- 

body. addChild (new com . thinairapps . tag . html .Anchor ("" , path + " ?action=clear&sid= " + 
sessionID, 

new com. thinairapps -tag .html .Text ^ 
( "new game" ) ) ) ; 

HTMLDoc .addChild (theTitle) ; 
HTMLDoc. addChild (body) ; 

resultString = HTMLDoc . render () ; 

return resultString; 



/** 

* WMLDisplayBoard ( ) returns the WML version of the board in its current state. 

* Oparam sessionID the current session ID 

* ©param theBoard the current state of the board 

* ©return an HTML table, containing a graphical representation of the board 
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*/ 

public com. thinairapps . tag -wml -Table WMLDisplayBoard (String sessionID, TicTacToeBoard ^ 
theBoard) 

{ 

com. thinairapps . tag .wml .Table 

TTTTable = new com. thinairapps . tag .wml . Table ( "Board" , "ALIGN_LEFT" , 3); 

com . thinairapps . tag .wml . TableCell 

Cell [] [] = new com. thinairapps . tag . wml . TableCell [theBoard .NUM_ROWS] [theBoard. kT 
NUM_COLS] ; 

com. thinairapps. tag. wml .TableRow 

Row[] = new com. thinairapps . tag -wml .TableRow [theBoard. NUM_ROWS] ; 

int rowCount, colCount; 
char curPiece; 

Random randGen = new Random () ; 

// append a random number to combat caching 

int randNum = Math. abs (randGen. next Int () % 10000); 

for (rowCount = 0; rowCount < theBoard. NUM_ROWS ,- rowCount++) \ 

Row [rowCount] = new com. thinairapps . tag . wml . TableRow () ; 
TTTTable. addChild (Row [rowCount] ) ,- 

for (colCount = 0; colCount < theBoard .NUM_COLS ; colCount++) { 

Cell [rowCount] [colCount] = new com. thinairapps. tag. wml .TableCell () ; 
Row [rowCount] . addChild (Cell [rowCount] [colCount] ) ; 

curPiece = theBoard. pieceOccupying (rowCount, colCount); 

if (curPiece == theBoard . EMPTY_SPACE) { 
Cell [rowCount] [colCount] .addChild 

(new com. thinairapps . tag -wml . Image (IMAGE_PATH + "/ttt-blank. 
gif", "?")); 
} else if (curPiece == 'X') { 

Cell [rowCount] [colCount] .addChild 

(new com. thinairapps. tag. wml. Image (IMAGE_PATH + "/ttt-x.gif " , "X")); 
} else if (curPiece == 'O') { 

Cell [rowCount] [colCount] .addChild 

(new com. thinairapps . tag .wml . Image (IMAGE_PATH + "/ttt-o . gif " , "O")); 

} ^ 

} 

return TTTTable; 

} 



/** 

* This method renders a WML page showing the board in its current state, along with the 

title, 

* and other explanatory information 

* Oreturn the rendered WML page . 
*/ 

private String WMLDisplayScreen (String sessionID, TicTacToeBoard theBoard) { 
String resultString ; 

DisplayCard theCard = new DisplayCard ( "cl " ) ; 
WMLTagDocument declt = new WMLTagDocument ( ) ; 

tint 0 % 10000) ; 
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try 
{ 

//get the cache for this session... 
cache = access .getSessionCache (sessionID) ; 

} 

catch (NoSuchSessionException e) { ) 

Integer GameState = (Integer) cache .get ( "GameState" ) ,- 

com. thinairapps . tag .wml . Paragraph p = new com. thinairapps . tag .wml . Paragraph () ; 
p. addChild{WMLDisplayBoard (sessionID, theBoard) ) ; 

if (GameState == USER_WON) 

p.addChild{new com. thinairapps . tag .wml .Text ( "You win! ")); 

!e if (GameState == CONNECTOR_WON) 

p . addChild(new com. thinairapps . tag . wml . Text (" I win! " ) ) ; 

else if (GameState == TIE_GAME) 

p.addChild(new com. thinairapps . tag . wml . Text ( "It ' s a tie! " ) ) ; 

else 

// the game is still in progress, let the user select the next move 

p.addChild{new com. thinairapps .tag. wml .Text ("Enter the cell # for your next move 

: ")); 
int rowNum, colNum; 
String cellNumString; 

for (rowNum = 0; rowNum < theBoard. NXJiyi_ROWS ; rowNum++) { 

for (colNum = 0; colNum < theBoard . NUM_COLS ; colNum++) { 
if ( theBoard. emptyAt (rowNum, colNum)) { 

cellNumString = Integer . toString ( (rowNum * theBoard . NUM_COLS ) + 
colNum + 1) ; 

p.addChild(new com. thinairapps . tag .wml .Anchor (path + "?row=" + 
Integer . toString (rowNum) + 
"&col=" + Integer . toString (colNum) + 
"&rnd=" + randNum + "&sid=" + 

sessionID, "", 

new com. thinairapps . tag .wml -Text (cellNumString) ) ) ; 



p.addChild(new com. thinairapps . tag .wml -Anchor (path + "?action=clear&rnd=" + 
randNum + 

"tamp; sid= " + sessionID, "", 
new com. thinairapps . tag. wml .Text ( "Play 
a new game " ) ) ) ; 

theCard.addChild(p) ; 
deck.addChild(theCard) ; 
resultString = deck , render () ,- 
return resultString; 



private void playTurn (String sessionID, TicTacToeBoard theBoard) 
( 

Character StartingPlayer , SecondPlayer ; 
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//the cache for this session 
Hashtable cache = null; 

try 
{ 

//get the cache for this session. . . 

cache = access .getSessionCache (sessionID) ,- 

} 

catch (NoSuchSessionException e) ( } 

Integer GameState = ( Integer) cache . get ( "GameState ") ,- 

// did the user just enter a move? 

if (props .getProperty( "row" ) != null) { 

int rowNum = Integer . parseint (props . getProperty ( "row" )) ; 
int columnNum = Integer .parseint (props .getProperty ( "col ")) ; 

// is the move valid? 

if (theBoard. emptyAt (rowNum, columnNum)) { 

theBoard.placePiece( 'X' , rowNum, columnNum); 

if (theBoard.playerWon{ 'X' ) ) { 

GameState = USER_WON; 
} else if ( theBoard . boardFull ( ) ) { 

GameState = TIE_GAME; 
} else { 

//GameState = ( Integer) cache . get ( "GameState" ) ; 
makeMove (theBoard) ; 

if (theBoard.playerWon ( 'O' ) ) { 

GameState = CONNECTOR_WON; 
} else if (theBoard.boardFullO ) { 

GameState = TIE_GAME; 

} 

} 

} 

} 



// if it's not a valid move, do nothing 

// if no move was entered, clear the board and start a new game 
else { 

GameState = IN_PROGRESS; 
theBoard. init ( ) ; 

if (cache .get ( "SecondPlayer" ) != null) { 

StartingPlayer = ( Character) cache . get (" SecondPlayer ") ; 

StartingPlayer = new Character ( 'X ') ; 



-f (StartingPlayer. charValue 0 == 'X') { 

SecondPlayer = new Character (' O ') ; 
■ else { 

SecondPlayer = new Character (' X ') ; 



cache .put ( "StartingPlayer" , StartingPlayer) ; 
cache .put ( "SecondPlayer" , SecondPlayer) ; 



if (StartingPlayer . charValue () 
makeMove (theBoard) ; 

} 
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} 

cache. put ( "GameState" , GameState) ; 

} 



* This is a simple exception rendering method. 

* Oparam message the message to be presented to the user 

* ©return the rendered HTML page deck 
*/ 

private String renderException (String message) 
{ 

//create the page 

HTMLTagDocument page = new HTMLTagDocument ( ) ; 

Body body = new Body ( ) ; 

//set the background color 
body.addAttribute( "bgcolor" , "#ffffff ") ; 

body. addChild (new com. thinairapps . tag . html . Text (message) ) ; 
body . addChild (new com. thinairapps . tag . html . Break () ) ; 

String resultString = body . render () ; 

return resultString; 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

import java.util.*; 
import j ava . io . * ; 

class TicTacToeBoard extends Object 
{ 

final int NUM_ROWS = 3 ,- 
final int NUM_COLS = 3 ,- 
final char EMPTY_SPACE = • ? ' ; 

//The board is represented as an array of characters 
private char PieceAt [] [] = new char [NUM_ROWS] [NUM_COLS] ; 

//Set each cell in the board to be blank 

public void init{) 

{ 

int rowCount, colCount; 

for {rowCount = 0; rowCount < NUM_ROWS ; rowCount++) 
{ 

for (colCount = 0; colCount < NUM_COLS; colCount++) 
{ 

PieceAt [rowCount] [colCount] = EMPTY_SPACE; 




} 



/** 

* Returns the character occupying the cell at row number rowNum 

* and column number columnNum 
*/ 

public char pieceOccupying { int rowNum, int columnNum) 
{ 

return PieceAt [rowNum] [columnNum] ; 

} 



* Returns whether the cell at row number rowNum and column 

* number columnNum is empty 
*/ 

public boolean emptyAtdnt rowNum, int columnNum) 
{ 

return (PieceAt [rowNum] [columnNum] == EMPTY SPACE) ; 

} 



/** 

* Inserts a piece of type player at the cell with 

* row number rowNum and column number columnNum 
*/ 

public void placePiece (char player, int rowNum, int columnNum) 
{ 

PieceAt [rowNum] [columnNum] = player; 



/** 
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* Returns whether or not the board is completely 

* filled with pieces 
*/ 

public boolean boardFull() 
{ 

int rowCount, colCount; 

for (rowCount = 0; rowCount < NUM_ROWS ; rowCount++) 
{ 

for (colCount = 0; colCount < NUM_COLS ; colCount++) 
{ 

if (PieceAt [rowCount] [colCount] == EMPTY_SPACE) 
return false ; 

} 

} 

return true; 



/** 

* Returns whether or not the player using the character 

* 'player' (either X or O) has a straight line of pieces in some^ 

* direction on the board 
*/ 

public boolean playerWon (char player) 
{ 

int rowCount, colCount; 
boolean Won; 

//Check for horizontal win 

for (rowCount = 0; rowCount < NUM_ROWS; rowCount++) 
{ 

Won = true; 

for (colCount = 0; colCount < NUM_COLS; colCount++) 
{ 

if (PieceAt [rowCount] [colCount] != player) Won = false; 

} 

if (Won) return true; 

} 

//Check for vertical win 

for (colCount = 0; colCount < NUM_COLS; colCount++) 
{ 

Won = true; 

for (rowCount = 0; rowCount < NUM_ROWS ; rowCount+-i- ) 
{ 

if (PieceAt [rowCount] [colCount] != player) Won = false; 

} 

if (Won) return true; 

} 

//Check for diagonal win 

for (rowCount = 0, colCount = 0; rowCount < NUM_ROWS ; rowCount++, colCount++) 
{ 

if (PieceAt [rowCount] [colCount] != player) Won = false; 

} 

if (Won) return true; 
Won = true; 

for (rowCount = 0, colCount = NUM_COLS - 1; rowCount < NUM_ROWS ; rowCount++, ^ 
colCount--) 

{ 

if (PieceAt [rowCount] [colCount] 1= player) Won = false; 

} 

if (Won) return true; 
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README.txt 



webscraper Sample Application 
wireless SDK for ThinAir Server 



About Thi s Sample 



This sample application contains both a Connector (SitnpleWebConnector. java) and 
a provider (SimpleWebProvi der. java) . These two pieces work together to combine: 

1. data access - via the ThinAir Storeprovi der API 
with 

2. device specific rendering - via the Device detection facilities in ThinAir 
server and the markup generating Tag Libraries 

into one distributed solution. 

when you contact the simplewebconnector with either a wireless device or web 
browser you will receive a UI asking for a URL. Enter a web address. The 
Connector will contact the SimpleWebProvi der to fetch the page. The 
SimolewebProvider will retrieve the web page, eliminate a1 I markup and 
unprintable characters, and return the raw text to the Connector. The 
gonnector will then render the page in approximately Ik chunks to each device 
TH Its own markup. You can scroll through the entire page, asking the 
connector for 'More' data via a link at the bottom of each screen. 



Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

* devices. jar 



sample Files 

This sample consists of the following file tree: 

connector.ini - sample connector configuration file 
provider.ini - sample provider configuration file 

webscraper.html - a static html page that can be used by a Palm Pilot 

PQA 

webscraper. jar - compiled Java code 

/src - Java source files for both the Connector and Provider 



Building the Sample 



compile the sample code using the :)ava compiler of your choice. Be sure to 
include the .jar files above in your CLASSPATH. 

install the connector classes and connector.ini configuration file into a 
subdirectory of the ThinAir server's /Connectors subdirectory, given a name 
of your choice. 
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README . txt 

Install the provider classes and provider.ini configuration file into a 
subdirectory of ThinAir server's /Providers subdirectory, given a name of 
your choice. 

The webscraper root directory contains, for the sake of simplicity, a single 
WebSCraper . ja'' file containing all the classes used by either the Connector or 
the Provider (or both). Instead of dividing up the application into two sets of 
classes, you can run both connector and provider by just placing a copy of this 
file in both directories. 

Start the ThinAir server, it should load simplewebconnector and 
Simpl ewebProvi der and initialize both. 



using the Sample 



wait until the ThinAir Server has started and both the connector and Provider 
have been loaded and initialized. From your wireless device, or web browser, 
enter the IP address listed as the value for Applicationpath in connector.ini 
(your ThinAi rserver IP address), followed by /samples/web. For a machine with 
IP address 111.222.12.34 this would be: 

http://lll.222.12.34/samples/web 

Follow the on-screen instructions. 

.Supported devices include WAP phones, HDML phones, palm Pilots, Windows CE 
idevices, desktop web browsers, and GO America/GO RIM pagers. To create a PQA 
application for the Palm vii that integrates with the ThinAir server, you 
will need to understand and use "Web Clipping" technology from Palm. Web 
Clipping involves essentially creating html interfaces into your applications. 
For your convienence, an HTML file (webscraper.html) has been provided for 
this purpose. To find out more about creating pqas and Web Clipping 
technology, visit: http://www.palmos.com/dev/tech/webclipping/ 



Last updated: 11.13.2000 
copyright 1999, 2000 ThinAi rApps Inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps . platform. * ; 
import com. thinairapps .platform. device . * ; 

//Rendering packages used to build markup 
import com. thinairapps . tag .* ; 
import com. thinairapps . tag . wml . * ,- 

//Core Java API 
import j ava . util . * ; 



/** 

* ©(#) WMLRenderer. java 

* Utility class containing static methods for rendering output in wrtil 
*/ 

..public class WMLRenderer 
O /** 

* Generate a WML page with a GUI with which the user can enter a URL 

* ©param connectorName the name of the Connector 

* ©param path the HTTP path that maps to this Connector 

* ©param reqProps the parameters of the original request + the session identifier 
*/ 

,2 public static String showURLInputUI ( String connectorName, String path. Properties 
reqProps) throws Exception 

=== WMLTagDocument deck = new WMLTagDocument ( > ; 

SinglelnputCard card = new SinglelnputCard { "url " , "Enter URL"); 

//Print the name of the Connector at the head of the card 

Paragraph p = new Paragraph (Paragraph. ALIGN_CENTER, Paragraph. MODE_WRAP ) ; 
p.addChild{ new Text ( "Welcome to " +connectorName) ) ; 
p.addChild( new Break ( ) ) ; 
card.addChild(p) ; 

// Construct the request URL 
// action (a) == get 

// url (url) == $url (to be filled in by the WML input element) 
// page number (pn) == start with the first chunk of data 

// session ID (sid) == determined in Connector and passed in request props param 
StringBuffer sb = new StringBuf f er (56) ; 
sb. append ( path ) ; 

sb . append ( " ?a=get&url = $ (url) &pn=0& sid= " ) ,- 
sb.append( reqProps .getProperty (" sid" ) ) ; 
sb . append ( " &amp ; rnd= " ) ; 

//Append a random number to combat caching 
sb. append ( Math . random ( ) ) ; 
String url = sb . toString ( ) . trim () ; 

card. buildCard (url, "Enter URL: "url", "*" + Input . FORMAT_ANY_LCASE_CHANGEABLE ) ; 

deck . addCard (card) ; 
return deck. render () ; 

} 
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* Generate a page displaying a portion of the requested web page 

* ©param connectorName displayed at the top of the page 

* ©param path used to issue another request 

* ©param reqProps the properties of the original HTTP request 

* ©param page the actual page text 

* ©param more indicates whether any more data is available 
*/ 

public static String showURLOutput ( String connectorName, String path. Properties reqPropskT 
String page, boolean more) 

{ 

String sessionID = reqProps . getProperty (" sid" ) ; 
String url = reqProps . getProperty ( "url ") ; 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

DisplayCard card = new DisplayCard{ "page" , connectorName); 

Paragraph p = new Paragraph(Paragraph. ALIGN_CENTER, Paragraph . MODE_NOWRAP ) ; 
p.addChild( new Text (url) ) ; 
card.addChild(p) ; 

p = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph . MODE_WRAP) ; 
p.addChild( new Text (page) ) ; 
p.addChild( new Break () ) ; 

//If there is more text to display, add an anchor to request the next IK 
StringBuffer sb; 

if (more) 
{ 

int pn = Integer .parseint ( reqProps . getProperty ( "pn" ) ) ; 

//Build the request url 

sb = new StringBuf f er ( 56 ) ,- 

sb. append (path) ; 

sb . append ( " ?a=get&:amp ; url= " ) ; 

sb . append ( url ) ; 

sb . append ( " &amp ; pn= " ) ; 

//increment the page number 

sb. append ( String . valueOf { ++pn ) ) ; 

sb . append ( " iamp ; sid= " ) ; 

sb. append ( sessionID ) ; 

sb . append ( " &amp rnd= " ) ; 

//Append a random number to combat caching 
sb . append (Math . random () ) ,- 

string href = sb . toString ( ) . trim () ; 

Anchor anchor = new Anchor ( new Go(href, false), new TextC'More") ) ; 
p.addChild(anchor) ; 

} 

card.addChild(p) ,- 



//Create a back button to take use back to the request page 
sb = new StringBuf fer (56) ; 
sb . append (path) ; 

//Append an empty action (a) so that the Connector returns the input page 
sb . append ( " ?a=&amp ; sid= " ) ,- 
sb . append (sessionID) ; 
sb . append ( " &amp ; rnd= " ) ; 



C: \TASS\WirelessSDK\ . . \Applications\WebScraper\src\WMLRenderer . j ava 



3 



//Append a random number to combat caching 
sb . append (Math . random ( ) ) ; 

Do button = new Do (Do.TYPE_ACCEPT, new Go ( sb . toString ( ) . trim ( ) , false )); 
button . addAttribute ( " label " , "Back" ) ; 
card. addChi Id (button) ; 

deck. addChild (card) ; 

String s = deck. render () ; 



/** 

* Generate a page describing an error that has occured 

* @param e Exception which you wish to render 
*/ 

public static final String renderExcept ion (Exception e) 
{ 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( "Error " , "Error"); 

card. buildCard ( "Error : "+-e .getMessage () , Paragraph. ALIGN_LEFT) ; 

deck. addCard (card) ; 
return deck . render ( ) ; 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality- 
import com. thinairapps. platform. * ; 
import com . thinairapps . platform . provider . * ; 
import java.util.*; 



/** 

* @ (#) WebProviderResult . java 

* This object is generated on the Provider to contain the results of a 

* web page query. The Connector unwraps it and displays the returned text 
*/ 

public class WebProviderResult extends Storeltem 
{ 

private String pageText ,- 
/** 

* Create a new WebProviderResult containing the processed text from a web page 

* ©param String text 
*/ 

public WebProviderResult (String text) 
{ 

super () ; 

pageText = text; 

} 



/** 

* ©return String the processed web page text 
*/ 

public String getTextO 
{ 

return pageText; 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core Java API 
import j ava . net . * ; 
import java.util . * ; 
import j ava . i o . * ; 



/** 

* ® (#) urlTool . java 

* This utility processes an HTML page and removes all markup 
*/ 

public class urlTool 

private final static String SPECIAL_CHARS [ 1 = { "Sinbsp;", 

"&#174", 

"&", 
"&#183" , 
"&#4 6; " , 

■'$■■ }; 

/** 

* Format a url to begin with http if it doesn't already then call process page 
*/ 

public static String getPageAndProcess ( String page, int skipLines) 

if ( Ipage.toLowerCaseO . startsWith ( "http: // " ) ) 
page = "http://" + page; 

return processPage (getPage (page) , skipLines) ; 

} 



/** 

* Remove all markup from a page and return it 

* (Sparam pageText - HTML contents 

* @param skipLines - return everything after this many lines 
*/ 

protected static String processPage (String pageText, int skipLines) 
{ 

pageText = removeJS (pageText ) ; 
pageText = removeTags (pageText) ; 
pageText = removeBlankLines (pageText ) ; 
pageText = removeSpecial (pageText) ; 

return pageText ; 

} 



/** 

* Format a url to begin with http if it doesn't already 
*/ 

protected static String checkURL (String page) 
{ 

if (! page.toLowerCaseO .StartsWith ("http://") ) 
page = "http://" + page ; 

return page; 



:\TASS\WirelessSDK\Samples\Applications\WebScraper\src\urlTool ■ java 



2 



/** 

* Remove all blank lines and new lines 

* oparam text source String 
*/ 

protected static String removeBlankLines (String text) 
{ 

StringBuffer output = new StringBuf f er () ; 
StringTokenizer st = new StringTokenizer (text , " \n" ) ; 
String line; 

if ( 1 St -hasMoreTokens ( ) ) 
{ 

output . append ( text ) ; 

} 

else 
{ 

while ( St .hasMoreTokens ( ) ) 
{ 

line = St -nextToken ( ) ; 
line = line. trim 0 ; 

if (line. length 0 > 0) 

output .append (line + "\n"); 

} 

} 

return output . toString () ; 

} 



/** 

* Remove all script tags from HTML 

* ©param htmlCode source HTML 
*/ 

protected static String removeJS (String htmlCode) 

htmlCode = removeTagPairContent (htmlCode , "<script", " </script> " ) ; 
htmlCode = removeTagPairContent (htmlCode , "<!-", "->"); 

return htmlCode ; 

] 



/** 

* Remove pairs of opening and closing tags 
*/ 

protected static String removeTagPairContent (String htmlCode, String start, String end) 
{ 

int i = 0; 

int endldx = 0; 

while ((i = htmlCode . indexOf (start, i) ) > 0) 
{ 

endldx = htmlCode . indexOf (end, i) ; 
if (endldx == -1) 
break; 

htmlCode = htmlCode . substring ( 0 , i ) +html Code . substring (endldx+end . length 0 , 

htmlCode . length () ) ; 
i = htmlCode . indexOf ( start , i ) ; 

} 
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eturn html Code ; 



/** 

* Remove the text specified in SPECIAL_CHARS 
*/ 

protected static String removeSpecial (String htmlCode) 



: SPECIAL_CHARS. length; 
new int [numSpecial] ; 



char dummy = (char) 0 ; 

char buf [] = htmlCode . toCharArray () ; 



outer: 



// Count how many SPECIAIi_CHARS have been found 



// Look through all the SPECIAL_CHARS 
for (i = numSpecial; --i >= 0; ) 



//No more SPECIAL t 
if (indexes [i] == -'- 



II Have ALL SPECIAL been found? 
if (++k == numSpecial) 
break outer; 

//Skip and keep LOOKING 
else 

continue inner; 



indexes [i] ) ; 



//Mark as all done 
indexes [i] = index; 



// Replace all chars in SPECIAL with dummy char 
for (j = SPECIAL_CHARS [i] -lengthO ; --j >= 0; ) 
{ 

buf [ index + j ] = dummy; 
- -newLen ; 
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//Advance indexes [i] to avoid repeats 
indexes [i] = index + 1; 

} 



StringBuffer sb = new StringBuf f er (newLen) ; 

//Copy all non-dummy chars into the return array 
for (i = 0; i < len; i++) { 
if (buf [i] == dummy) 



sb. append (buf [i] ) ; 

} 

return sb . toString ( ) . trim( ) ; 



/** 

* Remove anything that starts with a < and ends with a > 

* Oparam htmlCode source HTML 
*/ 

protected static String removeTags (String htmlCode) 
{ 

StringBuffer results = new StringBuf fer () ; 

StringTokenizer st = new StringTokenizer (htmlCode, "<") ; 

String text = null; 

while (st -hasMoreTokens ( ) ) 
{ 

text = st . nextToken ( ) ; 

text = text . substring (text .indexOf (">") +1) ; 

if (text. length 0 > 0 && ! text . equals ( "\n" ) && ! text . equals ( " ")) 
results .append (text + " ") ; 

} 

return results . toString () ; 

} 



/** 

* Fetch a page and return it 
*/ 

protected static String getPage (String urlString) 
{ 

try 
{ 

URLConnection uc = new URL (checkURL (urlString) ) . openConnection () ; 
return getStringFromStream (uc . getlnputStream () ) ; 

} 

catch (Exception e) 
{ 

e .printStackTrace ( ) ; 
return null; 
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/** 

* Read a page from an input stream 
*/ 

protected static String getStringFromStream { InputStream is) throws Exception 
{ 

StringBuffer sb = new StringBuffer (50000 ) ; 

Buf f eredReader br = new Buff eredReader (new InputStreamReader (is) ) ; 

String line = br.readLine ( ) ; 

while (line != null) 
{ 

sb . append (line + "\n"); 
line = br.readLineO ; 

} 

return sb . toString ( ) . trim ( ) ; 

} 



/** 

* Skip this number of lines into the page 
*/ 

protected static String skipLines (String page, int lines) 
{ 

if (lines == 0) return page; 

StringTokenizer st = new StringTokenizer (page , "\n" ) ; 

if (st -CountTokens ( ) > lines) 
( 

page = " " ; 

for (int i = 0; i < lines; i++) 
st . nextToken ( ) ; 

while (st . hasMoreTokens ( ) ) 

page = page + st . nextToken ( ) + "\n"; 

} 

} 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps .platform. provider . * ; 
import com. thinairapps . platform. exception . * ; 

//Core Java API 
import java.util . * ; 



@ C#) SimpleWebProviderContext 

Provides static information for and about the SimpleWebProvider 



public class SimpleWebProviderContext extends StoreProviderContext 



publi 



Static final short WEB_PROVIDER_RESULT = 



// Version information 

protected static final String VERSION 
protected static String APP_NAME 
protected static final String MANUF_NAME 
protected static final String MANUF_CONT 
protected static final String BUILD 
protected static final Date APP_RELEASED : 

private Properties props; 



"1.2"; 

"WebScraper" ; 
"ThinAirApps" ; 
"www . ThinAirApps . com" 

" 1 " ; 

new Date () ; 



/** 

* Determines if the context has optional user-editable properties. Implementors should 

* return true if they can offer optional Properties to the user, but do not require 

these 

* properties to be set in order to correctly serve user connections. StoreProviders mayi^ 

* both property types . 

* ©return A boolean indicating whether or not the context has optional properties. 
*/ 

public boolean hasOptionalProps ( ) 
{ 

return false; 

} 



/** 

* ©return ProviderOb j ectSet indicating the friendly and class names of Storeltem 

subclasses 

* understood by this StoreProvider . 
*/ 

public StoreProviderType getTypeO 
{ 

//Not used by this Provider 
return null; 

} 



/** 

* Called by a client to ask for product information on the Provider. 
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* ©return StoreProviderInf o containing information on this Provider. 
*/ 

public StoreProviderInf o getlnfo {) 
{ 

return new StoreProviderInf o { MANUF_NAME, 
MANUF_CONT, 
APP_NAME , 
VERSION, 
BUILD, 

APP_RELEASED ) ; 

} 



/** 

* Tells the context to update its property set. It will throw a 

SPInvalidContextPropsException 

* if it does not accept the properties. 

* @param props The new set of properties to commit. 
*/ 

public void updateProps (Properties p) { ; } // no provider-wide properties 



©return a boolean indicating whether or not the context can offer required properties. 



public boolean hasRequiredProps ( ) 
{ 



/** 

* Retrieves a ContextProperties object containing user-editable required and optional 

* properties 

* ©return ContextProperties object containing user- editable required and optional liT 

properties . 

*/ 

public ContextProperties getPropsO 

Properties required = (props == null) ? new Properties () : (Properties) props. clone \^ 
() ; 

return new ContextProperties ( new Properties () , required); 

} 

} 
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/** ACCESS TO AMD USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE S0FTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps .platform. provider. * ; 

//Core Java API 
import java.util.*; 
import java.net.*; 
import java.io.*; 



/** 

* @ (# ) SimpleWebProvider . java 

* This provider contacts an HTTP server, strips out all 

* of the markup, and returns its content to the Connector 
*/ 

public class SimpleWebProvider implements StoreProvider 
{ 

private static int counter = 0 ; 

private SimpleWebProviderContext myContext; 

private int instanceNuraber ; 

private Supportedl terns supportedl terns ; 



/** 

* Build a new SimpleWebProvider.. 
*/ 

public SimpleWebProvider () 
{ 

instanceNumber = ++counter; 

System. out -println ("Starting SimpleWebProvider "+instanceNumber+ " 



/** 

* Create a connection to the back-end data store and retrieve Supportedltems . Each \i 

* of a Provider represents a connection with the back-end store. A Connector writer \^ 

must 

* execute StoreProviderProxy ' s connectUser method before performing any other action 

with 

* regard to the Provider. 

* The Supportedltems object that is returned by the connectUser method wraps a Vector of 

* Supportedltem objects, indicating what items and actions a StoreProvider supports for 

a 

* given user. 

* ©return set of supported items based on user's access 

public Supportedltems connectUser (StoreProviderLogin login, StoreProviderContext context) 



supportedltems = new Supportedltems () ; 

String name = SimpleWebProviderContext .APP_NAME ; 

String location = null; 

try { 

location = inetAddress . getLocalHost ( ) . getHostAddress ( ) ; 
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} catch (Exception e) { 

location = "localhost " ; 

} 

// Support no actions 

short actions [] = new short [0]; 

Supportedltem item = new Supportedltem (SimpleWebProviderContext . WEB_PROVIDER_RESULT , \t 

name, location, actions) ; 
supportedltems.addltem(item) ; 

return supportedltems ; 



/** 

* The disconnectUser ( ) method logs a user off of a Provider. The Provider cannot be 

* used again until another user is logged on via the connectUser method. 
*/ 

public void disconnectUser ( ) 
( 

// Similarly, there is nothing to do at disconnect time 

System. out. printlnC'SimpleWebProvider "+instanceNumber+" shutting down."); 

} 



/** 

* Queries the StoreProvider for the locations it supports for the currently connected 

* user and returns the list. 

* For this simple Provider there is no user data location 
*/ 

public UserDataLocations getLocations (UserDataLocationRequest req) 
{ 

return null ; 

} 



/** 

* UserDataActions tell the provider to modify the backend data store in some way- 

* The only allowed modifications or "actions" are those specified when the user 

* logs on via connectUser. 

* This simple provider does not support any actions 

* ©param action describes the requested action 
*/ 

public UserDataActionResponse doUserDataAction (UserDataAction action) 
{ 

return null; 

} 



/** 

* The getUserData method is the means by a request is made for data from the data store. 

* This method is not used to performs action on data. 

* This Provider uses UserDataRequests to retrieve information from some back-end HTTP 

* It processes the request by extracting the url from the request, contacts the web 

server, 

* retrieves the data, and returns it to the Connector. 

* ©pararn request represents the UserData request object 
*/ 
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public UserData getUserData (UserDataRequest request) 
{ 

ItemRequest itemReq = request . requests [0] ; 

// Prepare the return object 
UserData ud = new UserData () ; 

ud. responses = new ItemRequestResponse [ 1 ] ; 
ud. responses [0] = new ItemRequestResponse () ; 
ud. responses [0] .request = itemReq; 

short type = itemReq. itemType; 

// Verify that the request is of the correct itemType 

if (type != SimpleWebProviderContext . WEB_PROVIDER_RESULT) 

throw new Runt imeExcepti on ( "Unknown item request type: "+type) ; 

// The requested URL is wrapped in a StringBound 

StringBound bound = (StringBound) ud. responses [0] .request .bounds [0] ; 
String url = (String) bound . getValue () ; 

// Use the URL request tool to retrieve the page and process the results 
String data = urlTool . getPageAndProcess (url , 0); 
WebProviderResult result = new WebProviderResult (data) 

// Finish loading the return object 

ud. responses [0] . items = new Storeltems ( ) ; 

ud. responses [0] . items . addElement (result) ; 



return ud; 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps . platform. provider . * ; 
import com. thinairapps .platform. connector . * ; 
import com. thinairapps .platform. device . *; 

//Core Java API 
import java.net.*; 
import java.io.*; 
import java.util . * ; 



/** 

* ® (#) SimpleWebConnector . java 

* This Connector provides wireless clients with a simple user interface for requesting 

* a WWW page. The web page is stripped down and returned as raw tex£ . 
*/ 

public class SimpleWebConnector implements Connector 
{ 

//Declare variables global to this Connector 
private ConnectorAccess connectorAccess ,- 
private String connectorName ; 
private String path; 



/**init() is called by the ThinAirServer when the Connector is loaded. It provides the 
Connector 

* with resources it needs to interact with the ThinAirServer. 

* ©param name indicates the friendly name of this Connector application. It is a String 

* derived from connector.ini and this sample does utilize it. 

* (Sparam path is the URL path to this Connector application. It is a String derived 

* from connector.ini and this sample does utilize it. 

* (Sparam iniProps is a Properties object containing developer assigned, t/^ 

connector- specif ic 

* properties. It is derived from connector.ini and this sample does not 1/ 
utilize it. 

* (Sparam ca is the one-and-only interface a Connector obtains to gain access to the 1^ 

runtime services 

* (such as session and user profile management) offered by the ThinAir xr 
Server to running 

* Connectors. This sample uses it. 

* Sparam appLog is used for logging. This sample does not use it. 
*/ 

public void init (String name. String path. Properties iniProps, ConnectorAccess ca, com. )^ 
thinairapps .plat form. connect or .ApplicationLog appLog) 

{ 

connectorName = name; 
connectorAccess = ca; 
this. path = path; 



/**getDevices 0 is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 1^ 
the names of all 
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* DeviceProf iles supported by this Connector. These names are the friendly names used ^ 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer \^ 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName ( ) method. 

* For more details about device detection and handling see the DeviceDetective sample \i 

connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports. 

*/ 

public String [] getDevicesO 

String [] devices = { "TA_WAP", "TA_UP_WAP", "TA_NOKIA_WAP" , 

"TA_PALM_VII" , "TA_GOWEB_PALM" , "TA_OMNISKY" , "TA_HTML" } ; 

return devices; 



/**The handle method implements the core logic of a Connector. I£ takes an incoming i^' 
request from a 

* particular device, and returns an appropriate response. This method is called wheneverar 

the server 

* receives a request from a type of device that the Connector indicates it supports, ^ 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of \t 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into \£ 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed \l 

information 

* on the capabilities of the particular device making the request. 

* ©param reqProps - represents the HTTP request 

* ©param device - the actual wireless device instance making the request 

* ©param out - the OutputStream to write back the response 
*/ 

public void handle (Properties reqProps, Device device, OutputStream out) throws 
lOException 

{ 

//This will hold the return markup 
String result = null; 

//Check the URL to see what action is being requested by the client 
String action = reqProps .getProperty ( "a" ) ; 



try 
{ 

//Is the user returning or is it their first time using the Connector? 
String sessionID = reqProps .getProperty ( "sid" ) ; 

if (sessionID == null || (! connectorAccess . sessionValid ( sessionID) ) ) 
{ 

//Create a session for this user 

//The session ID will be passed back and forth in the request URL 

sessionID = connectorAccess . createProviderSession (SimpleWebProviderContext . i^' 

APP_NAME) ; 
reqProps .put ( "sid" , sessionID) ; 
initProvider (sessionID) ; 

} 

//If this is the first request by the device 
if (action == null || action. equals ("") ) 
{ 

//Return the URL input page 
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result = showURLInputUI (reqProps, device); 

} 

else if (action. equals ( "get" ) ) 
{ 

//If the user has requested the URL input page 
string pn = reqProps .getProperty ( "pn" ) ; 

if (pn.equals (" -1") ) 
{ 

result = ShowURLInputUI (reqProps, device); 

} 

//Use the backend Provider to retrieve a page and process it 

//Cache the entire page and dole it out in IK chunlcs 

else 

result = getURL (reqProps, sessionID, device) ; 

} 

else 

throw new Exception ( "Unknown action: "+action) ; 

} 

catch (Exception e) 
{ 

//Catch all exceptions and generate an error page 
e .printStackTrace ( ) ; 

result = renderException (e, device); 

} 

out. write ( result . getBytes ( ) ); 

} 



/** 

* Generate a page with a URL input user interface 
*/ 

protected String showURLInputUK Properties reqProps, Device device) throws Exception 

//Use different utility classes to render output depending on the markup required by 

the device 
if (device instanceof WAPDevice) 

return WMLRenderer. ShowURLInputUI (connectorName, path, reqProps); 
else if (device instanceof HTTPDevice | | device instanceof PalmVIIDevice | | device 
instanceof GoWebPalmDevice | | 

device instanceof OmniSkyDevice | | device instanceof HTMLDevice ) 
return HTMLRenderer . showURLInputUI (connectorName , path, reqProps); 

//This simple web Connector does not support all devices 
else 

throw new Exception ( "Device "+device .getProf ile () .getName () + " not supported"); 

} 



/** 

* Retrieve a page either from cache or from the backend Provider and return it in IK 
chunks 

*/ 

public String getURL (Properties reqProps, String sessionID, Device device) throws 
Exception 

Hashtable sessionCache = connectorAccess .getSessionCache ( sessionID ); 
// the requested URL 

String url = reqProps . getProperty ( "url ") ; 
String page; 

String retString = null; 
int endlndex, length; 
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//Is the user asking for MORE of a page that has already been retrieved, 
//or is this a request for a fresh page? 
String pn = reqProps .getProperty ( "pn" ) ; 
if (pn == null) 



pn = "0 " ; 

reqProps . put ( "pn" , " 0 " ) ; 



//If this is a first-time request 

if (pn. equals ( "0" ) ) 

{ 

// retrieve the data 

page = requestPage (sessionID, url) ; 

// store entire page in session cache 
sessionCache .put ( "page" , page) ; 

// return first IK of text 
length = page.lengthO ; 
if (length < MAX_PAGE) 
( 

endlndex = length ; 
retString = page; 



elsi 



endlndex = MAX_PAGE; 

retstring = page . substring ( 0 , endlndex) 



//Retrieve the page from the session cache 
//Look at the pageNumber (pn) 

//Retrieve substring with chars (pn * iy[AX_PAGE) > (pn + 1) * MAX_PAGE 

//from the page 

int num = Integer. parseint (pn) ; 

page = (String) sessionCache. get ( "page" ) ; 

length = page . length ( ) ; 

endlndex = (num + 1) * MAX_PAGE; 

if (endlndex >= length) 

retString = + page . substring (num * MAX_PAGE) ; 

else 

retString = + page . substring ( num * MAX_PAGE, endlndex ) ; 

} 

//Use different utility classes to render output depending on the markup required by 

the device 
if (device instanceof WAPDevice) 

return WMLRenderer. showURLOutput (connectorName, path, reqProps, retString 
, (endlndex < length) ) ; 

else if (device instanceof HTTPDevice | | device instanceof PalmVlIDevice | ] device 
instanceof GoWebPalmDevice | | 

device instanceof OmniSkyDevice | | device instanceof HTMLDevice ) 
return HTMLRenderer. showURLOutput (device, connectorName, path, reqProps, 
retString, (endlndex < length) ) ; 

// this simple web Connector does not support all devices - return error 
else 

throw new Exception ( "Device " +device . getProf ile ( ) . getName ( ) + " not supported"); 



/* 

* Generate an exception page 
*/ 
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private String renderException (Exception e, Device device) 
{ 

//Use different utility classes to render output depending on the markup required by \^ 

the device 
if (device instanceof WAPDevice) 

return WMLRenderer . renderException (e) ; 
else if (device instanceof HTMLDevice) 

return HTMLRenderer . renderException (e) ; 

else 

return "ERROR: "+ e . getMessage () ; 



/* 

* Initialize the Provider that we will contact again when the user enters a URL 
*/ 

private void initProvider (String sessionID) throws Exception 
{ 

//Retrieve the St ore Provider Proxy for an existing session 
StoreProviderProxy spProxy = connectorAccess .getStoreProvider ( sessionID) ; 

//Construct this object for pedagogical purposes only 
StoreProviderLogin login = new StoreProviderLogin (null , null, null) ; 
Supportedl terns supports = spProxy.connectUser (login) ; 

if (supports == null) 

throw new Exception ( "Error in connectUser. Provider is unavailable"); 

} 



*Request a page from the Provider and return it 
*/ 

private String requestPage (String sessionID, String url) throws Exception 
{ 

//Retrieve the StoreProviderProxy for an existing session 
StoreProviderProxy spProxy = connectorAccess . getStoreProvider ( sessionID) ; 

//Construct the request object 

UserDataRequest request = new UserDataRequest () ; 
request . requests = new ItemRequest [1] ,- 
request . requests [0] = new ItemRequest () ; 

request . requests [0] . itemType = SimpleWebProviderContext . WEB_PROVIDER_RESULT; 

request . requests [0] .bounds = new Bound[l]; 

request -requests [0] .bounds [0] = new SirapleURLBound (url) ; 

//Contact the Provider and make the UserDataRequest 
UserData response = spProxy. getUserData (request) ; 

//Extract the data 

Storeltems items = response . responses [0] . items ; 

WebProviderResult result = (WebProviderResult) items . elementAt (0) ; 
return result . getText () ; 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE S0FTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps. platform. provider. * ; 



* @ (#) SimpleURLBound. java 

* Connectors and Providers can use this bound to request a specific URL 
*/ 

public class SimpleURLBound extends StringBound 
{ 

/** 

* Create a new SimpleURLBound to request a specific URL 

* ©param String the url to request 
*/ 

public SimpleURLBound {String url) 
{ 

super (url , StringBound . C0ND_EQU7VLS ) ; 

m } 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com. thinairapps .platform. * ; 
import com. thinairapps -platform. device. * ; 

//Rendering packages used to build markup 
import com. thinairapps . tag .* ; 
import com . thinairapps . tag . html . * ; 

//Core Java API ^ 
import j ava . util . * ,- 



/** 

* @ ( # ) HTMLRende r e r . j ava 

* A utility class containing static methods for rendering output in html 
*/ 

.p.ublic class HTMLRenderer 

/** 

* Generate a WML page with a GUI with which the user can enter a URL 

* ©param connectorName the name of the connector 

* ©param path the HTTP path that maps to this Connector 

* ©param reqProps the parameters of the original request -i- the session identifier 
*/ 

public static String showURLInputUI (String connectorName, String path. Properties 
reqProps) throws Exception 

{ 

//Create the basic "page" object, used for all HTML document rendering 
HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
U1 Head head = new HeadO; 

Meta meta = new MetaC'name", "PalmComputingPlatf orm" , "true"); 
head.addChild{meta) ; 

head. addChild (new Title ("Enter URL" ) ) ,- 

doc . setHead (head) ; 

//create the body 

Body body = new Body ( ) ; 

Font font = new Font ("geneva, arial" , 3 ) ; 
Break br = new Break ( ) ; 

//All children tags of this tag will be centered on the page 
Center center = new Center (); 

center. addChild ( new Text ( "<B>"+connectorName+"</B>") ) ; 
center .addChild ( br ) ; 

center. addChild ( new HorizontalRule ( ) ) ; 
center. addChild ( br ); 

font. addChild (center) ; 

//Create the form 

Form form = new Form( "getURL" , path, "GET"); 
//Add form input elements 

form.addChild( new Input ( "hidden" ^ "a", "get") ); 
form. addChild { new Input ( "hidden" , "pn", "0") ); 

form. addChild ( new Input ( "hidden" , "sid", reqProps . getProperty (" sid" ) ) ); 

f orm. addChild ( new Text("Enter URL: ") ) ; 

TextField text = new TextField ( "url " , "", 17); 

text . addAttribute ( new Attribute ( "maxlength" , "50") ) ; 
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form. addFormElement (text) ; 

forro.addFormEleraent (new SubmitButton ( "Go" ) ) ; 

font .addChild( form) ; 

body. addChild( font) ; 
doc . setBody (body) ; 

//Returns the entire rendered document text, suitable for display in an HTML browser 
return doc. render () 

} 



/** 

* Generate a page displaying a portion of the requested web page 

* ©param connectorName displayed at the top of the page 

* @param path used to issue another request 

* ©param reqProps the properties of the original HTTP request 

* @param page the actual page text 

* ©param more is there any more data available 
*/ 

public static String showURLOutput (Device device , String connectorName, String path, 
Properties reqProps, 

String page, boolean more) 

{ 

//Retrieve the SessionID from the URL and create a reference to it 
String sessionID = reqProps . getProperty {" sid" ) ; 

//Create the basic "page" object, used for all HTML document rendering 
HTMLTagDocument doc = new HTMLTagDocument ( ) ; 
Head head = new Head ( ) ; 

Meta meta = new Meta("name", " PalmComputingPlatf orm" , "true"); 
head.addChild(meta) ,- 

head . addChild (new Title (connectorName) ) ; 
doc. setHead (head) ; 

//create the body 

Body body = new Body ( ) ; 

//A tag indicated text styling parameters 
Font font = new Font ("geneva, arial" , 3 ) ; 
Break br = new Break ( ) ; 

//Get the URL that the user entered 
String url = reqProps .getProperty ( "url ") ; 

font .addChild ( new Text (url) ) ; 
font .addChild { br ); 

font .addChild ( new HorizontalRule ( ) ) ; 
font.addChild( br ) ; 
font.addChild( new Text(page) ) ; 
font.addChiId( br ) ; 

StringBuffer sb; 

//Turn simple links into anchor buttons 

Attribute button = new Attribute ( "BUTTON" , "BUTTON") { 
public String render () { return "BUTTON"; } 

}; 

//Get the page number that the user is on 

int pn = Integer .parseint ( reqProps .getProperty ( "pn" ) ); 

//Get the request action 

String action = reqProps .getProperty ( "a ") ; 



//If there's more of the page then construct the more link and increment the page \t 
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number variable 
if (more) 
{ 

// Build the request url 

sb = new StringBuf f er ( 56 ) ; 

sb. append (path) ; 

sb . append ( " ?a=get&amp ;url= " ) ; 

sb. append ( url ) ; 

sb . append ( " &amp ; pn= " ) ; 

// Increment the page number 
sb.append( String .valueOf ( ++pn ) ) ; 
sb . append ( " &amp ; s id= " ) ; 
sb. append ( sessionID ) ; 
sb . append ( " &amp ; rnd= " ) ; 

// Append a random number to combat caching 
sb . append (Math . random ( ) ) ; 

String href = sb . toString () . trim () ; 

Anchor anchor = new Anchor { "More", href, new Text ( "More ")) ; 
anchor. addAttribute (button) ; 

font .addChild (anchor) ; 

f ont .addChild(new Text ( " &nbsp ; &nbsp ; &nbsp ; " ) ) ; 

} 

// Now for the back link. . . 

// Depending on the device version, make the back link point to the appropriate ^ 

request page 
if (device instanceof HTMLDevice) 
{ 

//Build the request url 

sb = new StringBuf fer (56) ; 

sb. append (path) ,- 

sb.append( "?a=get&url=" ) ; 

sb. append ( url ) ; 

sb . append { " &amp ; pn= " ) ; 

// If there's more of the page, decrement the page number by 2 since we just 
incremented 

// it for the purposes of creating the 'more' link 

if (more) 

{ 

sb. append ( String . valueOf ( pn - 2 ) ) ; 

}^ 

e se 

sb.append{ Str ing. valueOf ( --pn ) ) ; 

} 

sb . append ( " &amp ; sid= " ) ; 
sb.append{ sessionID ); 
sb . append ( " &amp ; rnd= " ) ; 

//Append a random number to combat caching 
sb.append(Math.random{) ) ; 

String href = sb . toString (). trim () ; 

Anchor back = new Anchor ( "Back", href, new Text ("Back") ) ; 
back. addAttribute (button) ; 
font .addChild (back) ; 

body. addChild (font) ,- 



doc . setBody (body) ; 
return doc . render () ; 



C: \TASS\WirelessSDK\ . . \Applications\WebScraper\src\HTMLRenderer . j ava 



} 



* If its a palm device. . . 

* To create a PQA application for the Palm VII that integrates with the ThinAir Serveri^ 

* will need to understand and use "Web Clipping" technology from Palm. Web Clipping \l 

* essentially creating HTML interfaces into your applications. To find out more about 

* creating PQAs and Web Clipping technology, visit: http://www.palmos.com/dev/tech/ 
webclipping/ 

*/ 
else 
{ 

Anchor back = new Anchor { "Back", "f ile:webScraper.pqa" , new Text("Back") ); 
back. addAttribute (button) ; 
font.addChild(back) ; 

body. addChild( font) ; 

doc . setBody (body) ; 
return doc. render () ; 

} 



/** 

* Generate a page describing an error that has occured 

* ©param e - An exception which you wish to render 
*/ 

public static final String renderException (Exception e) 
{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ,- 
Head head = new HeadO ; 

Meta meta = new Meta("name", " PalmComputingPlatf orm" , "true"); 
head.addChild(meta) ; 

head. addChild (new Title("Enter URL")); 
doc . setHead (head) ; 

Body body = new Body ( ) ; 
Break br = new Break ( ) ; 

Font font = new Font { "geneva, arial " , 3); 
font.addChild( br ); 

font. addChild (new Text("ERROR: "+e.getMessage () ) ) ; 
body. addChild ( font ); 

doc. setBody ( body ); 

return doc . render () ; 

} 

} 
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What's in this Distribution 



The Distributed File Store provider allows individual users with a "ThinAir Powered Enterprise" to 
wireless enable access to a set of disk based documents. The Provider maps your file system directories 
and file names to Groupware "Messages" and "Folders". The type of files supported by this release 
include: 

-MS word 2000 Documents (.doc) 
-HTML Pages (.html,. htm) 
-Plain Text C.txt) 
-XML Documents C-xml) 
-Java Source Code C-java) 

This software also demonstrates the highly distributable capabilities of the ThinAir Server Platform. 



Security 



All authentication is done against existing NT Domain accounts. When you setup your TA Groupware Account, 
you must supply the following information: 

Provider: your personal provider name (specified in provider.ini) 
Host: your NT Domain (i.e. "taaps_lan") 
UserName: your NT Account Login 
Password: your NT Account Password 

Also, access to the file system is controlled by the same permissions granted to the user account which 
is running the provider. 



Installing the Application 



Here's a step by step: 

1) Copy the file "TAAuthUtils.dll" into your Windows or Wi nNT directory. 

2) Open the file "provider.ini" edit the properties: 

-provi derName=f. beano 

The ProviderName property must be a unique name. The scheme used above should be 
employed to help guarantee uniqueness within an NT domain. Replace "beano" with 
your NT login. 

-Defaul tBasePath=\\tapdc\data\ 

The Defaul tsasePath is the "root" location which the File Store Provider should browse 
-UserDi rectory : beano=\\tapdc\usr\beano\ 

TO specify a user specific directory, you can add "UserDi rectory :<NT Login>" parameters 
for every user, again, we recommend simply replacing "beano" with your NT Login. 



3) Launch the "StartProvider.bat" file. This should register your provider with the tas server running on 
10.1.1.47 (our primary thinair server). 

4) Now you need to setup an account with the TAS server in the same way you would for access to any 
standard Groupware Provider. 

-select your provider name from the drop-down list 

-For the host, enter our NT Domain "taaps_lan" 

-Enter your nt Login and password (or leave the password blank) 

-YOU can leave display, email blank 

-Name the account 
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README . txt 

-Save it! 

5) Now login! If your BaseDi rectory Path or UserDi rectory points to a directory with only folders inside 
of it, you first inbox" view will be blank, if you browse folders, you should be able to see all of the 
subdirectories. Select one with files, and your inbox" should get populated by them. 



Known issues 



-some MSWord documents cannot be opened 

-This has not been tested on windows 98, though it may work 



Support and Bug Reporting 



well, this is basically unsupported, but I would like to hear about certain bugs 
you may find, specifically regarding problems reading certain types of documents. 



Last updated: 8.18.2000 
copyright 1999, 2000 ThinAirApps, inc. 
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package thinairapps .groupware . storeproviders . f ile; 



import j ava . io . * ; 



public class DocumentConverter 
{ 

public final static String TYPE_TEXT = "text/plain" ; 

public final static String TYPE_HTML = "text/html"; 

public final static String TYPE_WORD = "application/msword" ; 

public static String readDocument (File file, String mimeType) 
{ 

try 

if (mimeType == null) 

return null; 
else if (mimeType .equals (TYPE_TEXT) ) 

return getASCII (file) ; 
else if (mimeType .equals (TYPE_HTML) ) 

return getHTML (file) ; 
else if (mimeType. equals (TYPE_WORD) ) 

return getMSWord (file) ; 

else 

\J return null; 

} 

catch (Exception e) 
{ 

return null; 

} 



public static String getASCII (File file) 

String data = readFile (file) ; 
return data; 



public static String getHTML (File file) 

String data = readFile (file) ; 
return HTMLRipper .processPage (data) ; 



public static String getMSWord (File file) 

String data = readFile (file) ; 

int startldx = data . indexOf ( "U" ) ; 

if (startldx != -1) 

return data . substring ( startIdx+1) . trim ( ) ; 

else 

return data; 



private static String readFile (File file) 
{ 

try 
{ 

FileReader fis = new FileReader (file) ; 

Buf f eredReader reader = new Buf f eredReader (fis) ; 

StringBuffer out = new StringBuf f er () ; 

String line = reader . readLine () ; 



while (line != null) 
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{ 

if (line. length () > 0) 

out. append (line + "\n"); 

line = reader. readLine () ; 

} 

return out . toSt ring {) ; 

} 

catch (lOException e) 
{ 

return "Unable to read file: " + 
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package thinairapps . groupware . storeproviders . f ile ; 

import javax.mail . * ; 
import javax.mail . internet .* ; 
import javax.mail . event .* ; 
import java.util.*; 

import javax. activation .* ; 



public class DocumentSender 
{ 

public static void sendDocument (String file. String server. String from. String to, 
String subject. String msgXextl) 

{ 

// create some properties and get the default Session 
Properties props = System. getProperties () ; 
props -put ( "mail . smtp. host " , server) ; 

Session session = Session .getDefaultlnstance (props , null); 
session. setDebug (false) ; 

try 

MimeMessage msg = new MimeMes sage (session) ; 
msg. set From (new Internet Address (from) ) ; 

InternetAddress [] address = {new InternetAddress (to) } ; 
msg. setRecipients (Message. RecipientType. TO, address) ; 
msg. setSubject (subject) ; 

// create and fill the first message part 
MimeBodyPart mbpl = new MimeBodyPart ( ) ; 
mbpl . setText (msgTextl) ,- 

// create the Multipart and its parts to it 
;=j Multipart mp = new MimeMultipart () ; 

mp . addBodyPart (mbpl) ; 

// create the second message part 
MimeBodyPart mbp2 = new MimeBodyPart ( ) ; 

// attach the file to the message 
FileDataSource fds = new FileDataSource (f ile) ; 
mbp2 . setDataHandler (new DataHandler (fds) ) ; 
mbp2 . setFileName (fds .getName ( ) ) ; 

mp . addBodyPart (mbp2 ) ; 

// add the Multipart to the message 
msg . setContent (mp) ; 

// set the Date: header 

msg . setSentDate (new Date ( ) ) ; 

// send the message 
Transport . send (msg) ,- 

} catch (MessagingException mex) { 

com. thinair .utils . DbgLog . logError (mex) ,- 
Exception ex = null; 

if ((ex = mex.getNextExceptionO ) != null) { 
com. thinair .utils .DbgLog . logError (ex) ; 
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package thinairapps . groupware . storeprovide 

import com. thinairapps .platform. provider. * 
import com. thinairapps .platform. exception. 



mport thinairapps . groupware . api . * ; 
mport thinairapps . groupware . api . acti' 



import java .util . Properties ; 

import java -util .Date; 

import java -util . StringTokenizi 

import j ava . io . * ; 



import com 
import com 
iport com 
import com 
import com 



ms . com. Variant ; 
ms . wf c . app . Time ; 
thinair .util s .Win3 2 .COMTypes; 
thinair .utils .DbgLogj- 
ms .Win32 .Advapi32 ; 



ty.peri 
ity.*; 
ms -Util . * ; 



^Mnport 
iSnport com.T 
■..import com.r 
/** 

:|:=* File StoreProvider that offers the following types of objects from the 
= ,y* GroupwareObjectSet: 

...:.* "message" - Message objects from a user's folder. The item locations correspond to 

\ti iMAP 

= * folders, the default being INBOX, 

©author meyerwil 

*/ 

i^ublic final class FileStoreProvider implements StoreProvider 
{ 

/y Version info 

protected static final String VERSION = "1.0 Early Access 2"; 

protected static final int BUILD = 1 ; 

protected static final String APP_NAME = "ThinAir File Provider" ; 

protected static final String MANUF_NAME = "ThinAirApps " ; 
protected static final String MANUF_CONT = "www.ThinAirApps.com"; 
protected static final Date APP_RELEASED = new Date (100, 0, 5); 

private final static int DOC_LENGTH_MAX = 25000; 

public static final int F0IjDER_SEPERATOR = 0x2F; 

Static final Variant V_FALiSE = new Variant (false) ; 
static final Variant V_TRUE = new Variant (true) ; 
static final Variant V_NOPARAM; 



public static final Variant V_PROPTAG_CONTAINERTYPE = new Variant 

private static final Variant V_PROPTAG_PUBLICSTORE_ROOT = new Variai 

private static final Variant V_PROFILENAME = new Variant (""); 

private static final Variant V_PW = new Variant (""); 

private static final Variant V_PARENTHWND = new Variant ((int)-l); 



private int m_currLocationDepth ; 
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private static final String DEFAULT_LOC = "Files"; 

private static String SMTP_HOST = "localhost" ; 

private static String MIME_TYPE_FILE_PATH = ". /mime . types " ; 

private StoreProviderLogin login; 

private final static String NO_BODY_MSG = "Document type not supported for viewing."; 

static 
{ 

V_NOPARAM = new Variant ( ) ; 

V NOPARAM . noParam ( ) ; 

} 

private static Properties mimeTypeMap; 
/** 

* Constructs an IMAPStoreProvider instance with an always-used FetchProf ile . 

* ®autlior meyerwil 
*/ 

public FileStoreProvider () 
{ 

if (mimeTypeMap == null) 
{ 

try 
{ 

loadMimeTypeFile (MIME_TYPE_FILE_PATH) ; 

} 

catch (Exception e) 
{ 

e .printStackTrace (); 

} 

} 

} 

private String getBasePath (String login) 
{ 

DbgLog. logStatus ("FileProv. looking up user basepath"); 
return FileStoreProviderContext .getUserDirectory (login); 



/** 

* Instances can share the javamail session, an LDAP handler, and the SMTP server throughn? 

the 

* context object. This method attempts to reuse shared resources or creates new ones if 

* needed. Upon completion, the session, smtp and Idap members will be adjusted with anyi^ 

shared 

* resources. 

* ©param popContext The POPStoreProviderContext instance shared across POPStoreProviders 

* Oauthor meyerwil 
*/ 

private void setupSharedStuf f (FileStoreProviderContext fileContext) 
{ 

SMTP_HOST = fileContext .m_props .getProperty ( "SMTPHost " ) ; 

MIME_TYPE_FILE_PATH = fileContext .m_props .getProperty ( "MimeTypeFilePath" ) ; 

} 

private void authenticateUser (StoreProviderLogin login) throws ^ 
AuthenticationFailedException 

{ 

//need to implement directory lookup here 
this. login = login; 
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if (AuthenticateUserByUsernamePassword (login. name, login. password, login. host) != 0) 
throw new AuthenticationFailedException ( ) ; 



/** @dll. import {"taauthutils.dll") */ 

private static native int AuthenticateUserByUsernamePassword (String userNarae, String 
password. String domain) ; 



/** 

* Logs a user on to an IMAP store using the information in login. A Caller must log on 

by 

* calling this function before doing anything else with the object. 

* ©param login An object containing the required login information. 

* ©param context A StoreProviderContext used for all StoreProvider instances. 

* ©return A Supportedltems object containing information on the supported actions and 

item types 

* for this user. 

* ©author meyerwil 
*/ 

public Supportedltems connectUser (StoreProviderLogin login, StoreProviderContext uC 
context) throws ProviderException 

{ 

short actions [] ; 

Supportedltems supportedltems; 
Supportedltem supportedltem; 
FileStoreProviderContext f ileContext ; 

// Make sure the password is correct 

DbgLog . logStatus { "FileGroupwareProvider. connectUser: Authenticating user"); 
authenticateUser (login) ; 

DbgLog . logStatus ( "FileStoreProvider . connectUser : Connecting. . .") ; 

if ((context == null) || [(context instanceof FileStoreProviderContext)) 

throw new InvalidContextException () ; 
f ileContext = (FileStoreProviderContext) context ; 
synchronized (this) 

{ 

try 

{ 

// Do item support stuff 
supportedltems = new Supportedltems (); 
actions = new short [2]; 

act ions [ 0 ] = Act ions . ADD_NEW_GROUPWARE_ITEM ; 
act ions [ 1 ] = Act ions . DELETE_GROUPWARE_ITEM ; 

supportedltem = new Supportedltem ( I temTypes . MESSAGE , "Files", DEFAUrjT_LOC, 
actions) ; 

supportedl terns. addltem (supportedltem) ; 

return supportedltems; 
} 

catch (Exception e4 ) 
{ 

throw new ProviderException (e4 + ": " + e4 . toString ( ) ) ; 
} 

} 

} 

/** 

* Returns all of the folders provided by the IMAP host. Location names will include 

* forward slashes ('/') to indicate the hierarchy. This provider supports only Message 

items 



C: \TASS\ ■ ■ \groupware\storeproviders\f ile\FileStoreProvider . java 



* and the caller must therefore not request locations for other types of items. 

* ©param req The request forlocations meeting certain criteria. 

* ©return A UserDataLocations object containing the retrieved locations that match the 

* requested criteria. 

* ©author meyerwil 
*/ 

public UserDataLocations getLocations (UserDataLocationRequest req) throws <^ 
Provi de rExcept i on 

{ 

File dir = null; 
String rootPath = null; 

if (req.rootLocation != null && ! (req. rootLocation. equals (DEFAULT_LOC) ) ) 

String path = getBasePath (login. name) + req. rootLocation. replace ( (char) 

FOLDER_SEPERATOR, ' \\ ' ) ; 
dir = new File (path) ; 
rootPath = req.rootLocation; 

else 

dir = new File (getBasePath (login. name) ) ; 



String[] dirList = dir. list (); 
String [] folderNames = new String [0]; 

if (dirList != null) 

Vector folders = new Vector {) ; 

File file; 

for (int i = 0; i < dirList . length; i++) 
{ 

file = new File (dir . getAbsolutePath ( ) + File . separator + dirList[i]); 

if (f ile . isDirectory ( ) ) 

{ 

if (rootPath != null) 

folders.addElement (rootPath + ( (char) FOLDER_SEPERATOR) + dirList [i] ) ; 

else 

folders . addElement (dirList [i] ) ; 



folderNames = new String [f olders . size ( ) ] ; 

for (int i = 0; i < f olders . size () ; i++) 

folderNames [i] = (String) folders . elementAt ( i) ; 

} 

return new UserDataLocations (req. itemType, folderNames); 

} 



* Closes a connection to the provider -- logs a user off. This method MUST be called iftf 

* user successfully logged-on using connectUser (). 

* @author meyerwil 
*/ 
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)id disconnectUser () throws ProviderExcepti 



* Retreives files that match the incoming request. This is the entry-point for 

* requesting any Message object The allowable bounds/fields are as follows: 

* Message: 

* (StringltemBound) 

* "body" 

* (DateltemBound) 

* "received" 

* @param req The request for specific data from the user's store. 

* ©return A UserData object containing the requested data. 

* ©author meyerwil 

public UserData getUserData (UserDataReguest req) throws ProviderException 
{ 

UserData data = new UserData {); 
data. responses = new ItemRequestResponse [1] ; 
data . responses [0] = new ItemRequestResponse () ; 
data. responses [0] .request = req. requests [0] ,- 

data. responses to] .items = new StoreItems() ; 

( (Storeltems) data . responses [0] .items) . setlsLastAvailable (true) ; 
String path = getBasePath (login. name) ; 

if (req. requests [0] .itemLocation != null && ! (req. requests [0] . itemLocation. equals wr 
(DEFAULT_LOC) ) ) 

path += req. requests [0] . itemLocation . replace ('/ ' , File . separatorChar) ; 

DbgLog.logStatus ("FileProv: accessing path: " + path) ; 

File dir = new File (path) ; 

String[] dirList = dir. list (); 

if (dirList != null) 

DbgLog.logStatus ("FileProv: got directory listing; size=" + dirList . length) ; 

else 

throw new AuthenticationFailedException ( ) ; 



File file; 
Message msg ; 
String mimeType; 
String fileExt; 

int startldx = 0; 

if (req. requests [0] . startID != null) 

startldx = new Integer (req. requests [0] . startlD. substring (0 , req. requests [0] 
StartID. indexOf (":"))). intValue () + 1; 

for (int i = startldx; i < dirList . length; i++) 
{ 

file = new File (path + "\\" + dirList [i]); 
if ( ! f ile . isDirectory ( ) ) 
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DbgLog . logStatus ("FileProv: examining file: " + f ile .getName ( ) ) ; 
msg = new Message ( ) ; 

( (Storeltem)msg) .setID (i + ":" + f ile .getAbsolutePath ( ) ) ; 

msg . setReceivedDate (new Date ( file . lastModified {))) ; 
msg. setRead( false) ; 

msg . addRecipient (Message . RecipientType . TO , new GroupwareUserSMTPAddress (logini^ 
.name, login. name) ) ; 

mimeType = null ; 
fileExt = "NONE"; 

if (file .getName (). indexOf (".") != -1) 
{ 

fileExt = file .getName (). substring ( file . getName (). lastlndexOf (".")+l); 
mimeType = mimeTypeMap . get Property { fileExt . toLowerCase ()) ; 

} 



msg.setFrom (new GroupwareUserSMTPAddress ( fileExt . toUpperCase (), fileExt . ^ 
toUpperCase 0 ) ) ,- 

String body = null; 

try 
{ 

body = DocumentConverter. readDocument (file, mimeType) ; 

} 

catch (Exception e) 
{ 

DbgLog . logError ("error reading file: " + e) ; 
DbgLog . logError (e) ; 

} 

if (body != null) 
{ 

if (body. length () > DOC_LENGTH_MAX) 

body = body. substring (0, DOC_LENGTH_MAX) ; 

msg . setSubj ect ("*" + f ile . getName ()) ; 
msg.setBody (body); 

} 
I 

msg . setSubj ect (file .getName ( ) ) ; 
msg.setBody (NO BODY MSG); 
} ~ " 

data . responses [0] . items . addElement (msg); 



if (data . responses [0] . items . size ( ) == req. requests [0] .max) 
{ 

if (i < dirList.length-1) 

( (Storeltems) data. responses [0] .items) . setlsLastAvailable (false); 

else 

( (Storeltems) data. responses [0] .items) .setlsLastAvailable (true) ; 
brealc; 



DbgLog. logStatus ("FileProv: returning message set"); 
return data; 
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/** 

* Performs some action on the user's data. This provider only supports 

"add", "delete", and 

* "markseen" actions, passed as UserDataAdd, UserDataDelete , and UserDataMarkSeen 

objects. 

* Adding an item means sending an email message. 

* @param action The action to be performed on the user data. 

* ©return A UserDataActionResponse containg the results of the action. 

* ©author meyerwil 
*/ 

public UserDataActionResponse doUserDataAction (UserDataAction action) throws 
ProviderException 

{ 

thinairapps .groupware . api .Message gwMsg = null; 

synchronized (this) 
{ 

if (action instanceof AddNewGroupwareltem) 
{ 

GroupwareUserAddress recips[]; 
GroupwareUserAddress tempAddr; 

// We're going to "add" the message, meaning send it 

gwMsg = (thinairapps .groupware . api .Message) ( (AddNewGroupwareltem) action) . 
getltem () ; 

try 

{ 

if (gwMsg instanceof ForwardedMessage) 
{ 

String filePath = ( (ForwardedMessage) gwMsg) . getOriginallD ( ) ; 

int sidx = filePath. indexOf (":") + 1; 

filePath = filePath. substring (sIdx) 

File file = new File (filePath) ; 

String from = gwMsg .getProm ( ) . getAddress ( ) ; 

StringBuffer to = new StringBuffer (); 

GroupwareUserAddress!] toz = gwMsg .getRecipients (Message. 

RecipientType .TO) ; 
for (int n = 0 ; n < toz. length; n++) 
{ 

to.append (toz [n] .getAddress ()); 

if (n+l < toz. length) 
to . append ( " ; " ) ; 

} 

String subject = gwMsg.getSubject () ; 
String message = gwMsg . getBody (); 

DbgLog . logStatus ("Sending file to '" + to . toString ( ) + "': " + 
f ile .getName 0 + " via " + SMTP_HOST) ; 

DocumentSender . sendDocument (f ile.getAbsolutePath (), SMTP_HOST, 
from, to. toString 0 , subject, message); 

} 

else 

throw new InvalidActionException (); 

} 

catch (Exception e) 
{ 

if (e instanceof ProviderException) 
throw (ProviderException) e ; 
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DbgLog . logError ("Caught unknown exception adding item: " + e.toString 
0 ) ; 

throw new ProviderException ("Unable to create item."); 
} 

} 

else 

throw new InvalidActionException (); 

} 

return null; 

} 



/** 

* ©param mimeTypeFilePath the file path to the Internet Mime Types file 

* which contains mappings from mime types to file extensions 
*/ 

private static void loadMimeTypeFile (String miraeTypeFilePath) throws 
FileNotFoundException, lOException 

{ 

mimeTypeMap = new Properties () ,- 

File file = new File (mimeTypeFilePath) ; 

if ( Ifile.existsO ) 

throw new FileNotFoundException () ; 

FileReader fis = new FileReader (file) ; 

Buf f eredReader reader = new Buf f eredReader (fis); 

String line = reader . readLine () ; 

String mimeType = null, extension = null; 

while (line != null) 
{ 

line = line.trimO; 

if ( !line.startsWith("#") && line . length ( ) > 0) 
{ 

StringTokenizer st = new StringTokenizer (line) ; 

mimeType = st . nextToken () ; 

while (st -hasMcreTokens () ) 
{ 

extension = st . nextToken () ; 
mimeTypeMap . put (extension, mimeType) ; 

} 

} 

line = reader . readLine 0 ; 

} 

fis.closeO ; 

} 



} 
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package thinairapps .groupware . storeproviders . f ile; 

import com. thinairapps . platform. provider . * ; 

import java.util .Properties, - 
import java.util .Enumeration ; 

/** 

* Defines a context object for the IMAP provider. 

* ©author meyerwil 
*/ 

public final class FileStoreProviderContext extends StoreProviderContext 
{ 

// Data members 

protected static Properties m_props = null; 

private static Properties basePathStore ; 

private static final String USER_PROP_KEY = "UserDirectory : " ; 
/** 

* Retrieves the object set supported by this provider -- the Groupware object set. 

* ©return A GroupwareOb j ectSet instance. 

S * ©author meyerwil 

*/ 

public StoreProviderType getType () 
{ 

return new StoreProviderType ( "thinairapps . groupware . api" ) ; 



/** 

* Retireves a Context Properties object containing user-editable required and optional 

* properties . 

* igreturn Context Properties object containing user-editable required and optional wr 

properties . 

* ©author meyerwil 
*/ 

public Context Properties getProps () 
{ 

Properties optional; 
Properties required; 

optional = new Properties () ; 
required = new Properties () ; 

return new ContextProperties (optional, required); 

} 

/** 

* Tells the context to update its property set. It will throw a 

SPInvalidContextPropsException 

* if it does not accept the properties. This provider does require an SMTP server so itxr 

will 

* throw the exception if the user didn't specify one. 

* @param props The new set of properties to commit. 

* ©author meyerwil 
*/ 

public void updateProps (Properties props) 
{ 

m_props = props; 
Enumeration keys = m_props .keys () ; 
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String user, dir; 

basePathStore = new Properties ( ) ; 

while (keys . hasMoreElements { ) ) 
{ 

user = (String) keys . nextElement () ; 

if (user . startsWith (USER_PROP_KEY) ) 
{ 

dir = m__props .get Property (user) ; 

user = user. substring (USER_PROP_KEY . length ()) ; 

basePathStore .put (user, dir); 

} 

} 

} 

public static String getUserDirectory (String name) 
{ 

String path = basePathStore .getProperty (name) ; 

if (path != null) 
return path; 

else 

return m__props . getProperty ( "Def aultBasePath" ) ; 

} 



/** 

* Determines if this context has optional user-editable properties. This context does 

* -- the LDAP server. 

* ©return Boolean true to indicate that this context does have optional properties. 

* ©author meyerwil 
*/ 

public boolean hasOptionalProps () 
{ 

return false; 

} 

/** 

* Determines if the context has required user- editable properties. This context does iiT 

-- the 

* SMTP server. 

* ©return Boolean true to indicate that this context does have required properties. 

* ©author meyerwil 
*/ 

public boolean hasRequiredProps () 
{ 

return true; 

) 

/** 

* This method indicates product information for the provider. 

* ©return A StoreProviderInf o object containing product information. 

* ©author meyerwil 
*/ 

public StoreProviderlnfo getlnfo () 
{ 

return new StoreProviderlnfo (FileStoreProvider.MANUF_NAME, 
FileStoreProvider .MANUF_CONT , 
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FileStoreProvider . APP_NAME , 
FileStoreProvider. VERSION, 
FileStoreProvider . BUILD, 
FileStoreProvider .APP_RELEASED) ; 



} 



C : \TASS\ ■ ■ \groupware\storeproviders\f ile\HTMLRipper ■ ja- 



package thinairapps .groupware . storeproviders . file 

import java.util . StringTokenizer ; 

public class HTMLRipper 
{ 

private final static String SPECIAL_CHARS [] 



{ "&nbsp 

" &#174" 
"& " 
"&#183" 
" S:#46;" 



"\r"}; 



■ remove anything that starts with a < and ends i 

■ Oparam htmlCode source HTML 



ith i 



public static String : 



■esults 



eTags (String htmlCode) 

new StringBufferO ; 
.ew StringTokenizer (htmlCode, "<") ; 



StringBuff er 
StringTokeni: 
String text = null; 
while (st -hasMoreTokens () ) { 
text = St . next Token ( ) ; 

text = text . substring (text . indexOf (">") +1) ; 

if (text. length 0 > 0 && ! text . equals ( "\n" ) && 1 text . equals ( " 
results, append (text + " ") ,- 



results . toString ( ) ; 



a < and ends with a > 

public static String removeTagsExcept (String htmlCode, String [] tags) 
{ 

StringBuff er results = new StringBufferO; 

StringTokenizer st = new StringTokenizer (htmlCode, "<") ; 

String text = null; 
String tag = null; 
while (st . hasMoreTokens 0 ) { 

text = st .nextTokenO ; 

tag = text . substring ( 0 , text . indexOf (">")). t 

for (int i = 0; i < tags. length; i++) 
{ 

if (tag.startsWith (tags [i] ) ) 

results .append ("<" + tag + ">"); 



toLowerCase { ) ; 



text = text . substring (text . indexOf ( " 
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if (text. length 0 > 0 1 text . equals (" \n 

results. append (text) ; 



return results . toString () ; 

} 

/** 

* remove the text specified in SPECIAL_CHARS 
*/ 

public static String removeSpecial (String htmlCode) { 

int numSpecial = SPECIAL_CHARS . length; 
int indexes [] = new int [numSpecial] ; 



char dummy = (char) 0 ; 

char buf[] = html Code. toCharArray () ; 



while (true) { 

k = 0; // count how many SPECIAL_CHARS have been found 

>= 0; ) { // look through all the SPECIAL_CHARS 

if (indexes [i] == -1) { // no more SPECIAL to be found 

if (++k == numSpecial) // have ALL SPECIAL been found? 

break outer ; 
else // skip and keep LOOKING 
continue inner; 

} else { 

// look for more of SPECIAL 

index = htmlCode . indexOf (SPECIAL_CHARS [i] , indexes[i]); 

if (index == -1) { // no more SPECIAL 

indexes [i] = index; // mark as all done 
continue inner; // continue to next 



// replace all chars in SPECIAL with dummy char 
for (j = SPECIAL_CHARS [i] .lengthO ; --j >= 0; ) { 

buf [ index + j ] = dummy; 

--newLen; 



indexes [i] = index +1; // advance indexes [i] to avoid repeats 



// FIXME FIXME FIXME 

// use newLen and array-based implementation 
// 

StringBuffer sb = new StringBuffer (newLen) ; 

// copy all non- dummy chars into the return array 
for (i = 0; i < len; i++) { 
if (buf [i] == dummy) 
continue ; 

sb. append (buf [i] ) ; 
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return sb.toStringO .trimO ; 

} 



/** 

* remove pairs of opening and closing tags 
*/ 

public static String removeTagPairContent {String htmlCode, String start, String end) { 

int i = 0; 

int endldx = 0 ,- 

while ((i = htmlCode . indexOE {start, i) ) > 0) { 
endldx = htmlCode . indexOf (end, i) ; 
if (endldx == -1) 
break; 

htmlCode = htmlCode . substring (0 , i) +html Code . substring (endldx+end. length () , 

htmlCode . length ( ) ) ; 
i = htmlCode. indexOf (start, i) ; 

} 

return htmlCode; 

} 



/** 

* remove all script tags from HTML 

* (Sparam htmlCode source HTML 
*/ 

public static String removeJS (String htmlCode) { 

htmlCode = removeTagPairContent (htmlCode , "<script", "</script>" ) ; 
htmlCode = removeTagPairContent (htmlCode , "<!-", "->"); 

return htmlCode ; 

} 

/** 

* remove all blank lines and new lines 

* @param text source String 
*/ 

public static String removeBlankLines (String text) { 
StringBuf fer output = new StringBuffer () ; 
StringTokenizer st = new StringTokenizer (text,"\n"); 
String line; 

if ( 1 St -hasMoreTokens ( ) ) { 
output. append (text) ; 

) else { 

while ( St .hasMoreTokens () ) { 
line = St . nextToken 0 ; 
line = line. trim 0 ; 

if (line. length 0 > 0) 

output .append (line + "\n"); 

} 

} 

return output . toString () ; 

} 
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public static String processPage {String pageText) 
{ 

pageText = removeJS (pageText ) ; 
pageText = removeTags {pageText ) ; 
pageText = removeBlankLines (pageText ) ; 
pageText = removeSpecial (pageText) ; 

return pageText; 

} 



README . txt 



TextFile Sample Groupware provider 
wireless SDK for ThinAir Server 



About This Sample 



This sample Groupware Provider is compatible with any of the ThinAir Groupware 
connectors included in the standard server installation. It demonstrates 
a simple provider that reads data out of a text file data store, caches it, 
and services requests from the cache. The Provider currently ignores all of 
the request parameters and returns all messages in the cache with every 
request, it could easily be modified to pay attention to the 'max' member of 
the itemRequest or the request bounds and filter the returned data in some way. 
consult the ThinAir Platform API for information on the UserDataRequest / 
useroataResponse protocol . 



Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* groupware. jar 

This sample does not require any other external apis. 



sample Files 

This sample consists of the following file tree: 

provider_integrated.ini and provider_standalone.ini - two possible config 
files, one of which should be copied into provider.ini 

sourceFile.dat - a delimited text data file 

sourceFileKey.txt - template for the data file format 

TextFileProvider. jar - compiled Java code 

\src - Java source files 



Building the Sample 



compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

install the compiled sample code and provider.ini configuration file into a 
subdirectory of the ThinAir Server's \providers subdirectory, given a name 
of your choice, if you are running TextFileProvider as an in-memory 
StoreProvider copy provider_integrated.ini into Provi ders/provider . i ni . if you 
are running TextFileProvider as a standalone StoreProvider, copy 
provi der_standalone into Providers\provider.ini before you begin. Within 
provider.ini under the [Provider settings] heading, the sourcePile setting 
should point to the installation directory of the sourceFile.dat file on 
the machine hosting the Provider. 



start the ThinAir Server; it will load the sample code and begin executing it. 



Page 1 



Copyright 1999, 2000 Thir 



sourceFi 1 eKey . txt 

<username> | <password> 

# Each message is encoded in a block like the one below 

<sender's display nanie>| 

<sender's email address>| 

<sent date in M-d-y h:mm a format>| 

<subject> I 

<body> 



page 1 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Thinairapps Imports 

import thinairapps . groupware . api . * ; 

import thinairapps . groupware . api . actions . * ; 

import thinairapps . groupware . api . bounds . * ; 

import thinairapps .groupware . api .exception. * ; 

import com. thinairapps .platform. provider . * ; 
import com. thinairapps .platform. exception. * ; 

import com. thinair .utils . * ; 

//Standard Java Imports 
import j ava . text . * ; 
import j ava . ut i 1 . * ; 
import j ava . net . * ; 
import java.io.*; 



/** 

1=1* @(#) TextFileProvider . java 

i'f* Read a PIPE-delimited text file containing encoded messages 
* and deliver them to a Connector as Groupware objects 
*/ 

ifpublic class TextFileProvider implements StoreProvider 

private static int counter = 0 ; 

private Support edit ems supportedltems ; 
private String username, password; 
private Vector messages; 
private SimpleDateFormat dateFormatter ; 
private int instanceNumber ; 

//Error code from the ThinAir Groupware Access application. 
//Provider writers may define error codes for their own applications 
public static final int ERROR_AUTHENTICATION_FAILED = 4310; 



/** 

* build a new TextFileProvider 

* for the simple web provider there is nothing to do here 
*/ 

public TextFileProvider ( ) 
{ 

instanceNumber = ++counter; 

System. out .println( "Starting TextFileProvider "+instanceNumber+" . . .") ; 
dateFormatter = new SimpleDateFormat ( "M-d-y h:mm a"); 

// this cache holds all the messages in the source file 
messages = new Vector () ; 

} 



/** 

* Load the source file 

* Parse its contents into a username, password, and Message objects 

* authenticate the user's login based on username/password 

* (Sreturn set of supported items 
*/ 

public Supportedltems connectUser (StoreProviderLogin login, StoreProviderContext ^ 
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context) throws ProviderException 

{ 

try 
{ 

// this will also obtain username and password info from the file 
loadSourceFile ( ( (TextFileProviderContext ) context) .props) ; 

} 

catch (Exception e) 
{ 

System. out .print In ( "Caught an exception logging in: " + e .getMessage () ) ; 

//In a actual application, you would define your own error code 

throw new ProviderException (e .getMessage () , ProviderException. NO ERROR CODE); 

} 

// authenticate login 

if (! authenticateUser (login) ) 

//In an actual application, you would define your own error code 
throw new AuthenticationFailedException (ERROR_AUTHENTICATION_FAILED) ; 

// prepare the return object 

support edit ems = new Suppor t edit ems {) ; 

String name = TextFileProviderContext .APP_NAME ; 

String location = null ; 

:;=: try 
{ 

location = InetAddress .getLocalHost () .getHostAddress () ,- 

^ } 

: catch (Exception e) 



// support no actions 

short actions [] = new short [0] ; 

Supportedltem item = new SupportedItem(ItemTypes .MESSAGE, name, locatic 
support edi t ems. addit em (item) ; 

// return the completed Supportedltem set 
return supportedltems ,- 



* disconnect a user - nothing to do for this simple Provider 
*/ 

public void disconnectUser ( ) 
{ 

System. out . println { "TextFileProvider " +instanceNumber+ " shutting down." 



* not implemented for this simple Provider 
*/ 

public UserDataLocations getLocations (UserDataLocationReguest req) 
{ 

UserDataLocations Iocs = new UserDataLocations ( ItemTypes .MESSAGE , new String[0]); 
return Iocs; 

} 
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* UserDataActions tell the provider to modify the backend data store in some way 

* This simple Provider does not support any actions 

* @param action describes the requested action 
*/ 

public UserDataActionResponse doUserDataAction (UserDataAction action) 
{ 

return null ; 

} 



/** 

* The source file was loaded and cached in connectUser ( ) 

* Service requests for messages here 

* Oparam request represents the UserData request object 
*/ 

public UserData getUserData (UserDataRequest request} 
{ 

ItemRequest itemReq = request . requests [0] ; 

// prepare the return object 
UserData ud = new UserData (); 

ud. responses = new ItemRequestResponse [ 1 ]; 
ud. responses [0] = new ItemRequestResponse () ; 
ud. responses [0] .request = itemReq; 

short type = itemReq. itemType ; 

// verify that the request is of the correct itemType 
if (type != ItemTypes. MESSAGE) 

throw new RuntimeException ( "Unknown item request type: 



// load the responses [0] .items Vector with Message objects from the messages cache 
ud. responses [0] . items = new Storeltems ( ) ; 

// ignore bounds and max 
// return entire cache every time 
int numMessages = messages . size () ; 
for (int i = 0 ; i < numMessages,- i++) 

ud. responses [0] . items . addElement ( messages . elementAt (i) ); 

// N.B. if we had implemented bounded requests by filling in the responses [0] .bounds 
array 

//we could ask for a subset of the cached messages, and page back and forth within ^ 
the 

// cache, retrieving the first 5, then the next 5, ect. 

// for now, make the Connector assume that the entire cache is returned each time 
ud. responses [0] . items . setlsLastAvailable (true) ; 

// return completed response object 
return ud; 



/* 

* Read and parse the source file 

* Determine username and password 

* Generate Message objects 
*/ 

private void loadSourceFile ( Propert ies props) throws Exception 
{ 

//Get the SourceFile value from provider.ini 

String sourceFile = props .getProperty ( "SourceFile" ) ; 
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//Separate the sourcePath into filepath and fileName 
//look for the last instance of the \ String 
String lastDivider = "\\"; 

//Get the divider's index in the String 

int lastlndex = sourceFile . lastlndexOf ( lastDivider) ; 

//Get the sourcePath 

String sourcePath = sourceFile . substring ( 0 , lastIndex+1) ; 
//Get the file name 

String fileName = sourceFile . substring (lastlndex+l , sourceFile . length ()) ,- 
byte buf [] = null; 

//File file = new File (sourceFile) ; 

File file = new File ( sourcePath, fileName); 

buf = new byte [ (int) file.lengthO ] ; 

try 
{ 

FilelnputStream fis = new FilelnputStream ( file ) ; 

while (fis. read (buf ) != -1) ; 
fis. close 0 ; 
} catch (Exception e) { 

throw new Exception ( "Cannot find / read source file: " + f ile .getAbsolutePath () ) ,- 

} 

System. out .printin ( "TextFileProvider "+instanceNumber+" loading data from "+file. ^ 
getAbsolutePathO ) ; 

// buf now contains full file data 
String content = new String (buf ) ; 

// use the Tokenizer to parse the data into Message objects 
parseSourceFile (content) ; 

} 



/* 

* Parse the source data 

* Extract username / password 

* Generate Message objects for the rest 
*/ 

private void parseSourceFile (String content) throws Exception 
{ 

Tokenizer tok = new Tokenizer (content , ' | ') ; 

username = tok.nextTokenO ; 
password = tok.nextTokenO; 

Message msg = null; 
GroupwareUserSMTPAddress address ; 
while (tok.hasMoreTokens ( ) ) 
( 

// displayName, email address 
msg = new Message (); 

address = new GroupwareUserSMTPAddress ( tok . nextToken () , tok.nextTokenO); 
msg . setFroTti (address) ; 

msg . setReceivedDate ( dateFormatter . parse ( tok.nextTokenO ) ); 
msg . setSubj ect ( tok.nextTokenO ); 
msg.setBodyl tok.nextTokenO ); 



/ / add to global messages Vector 
messages .addElement (msg) ; 
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System. out .println (messages . size {)+ " Messages parsed by TextFileProvider 
instanceNumber) ; 



/* 

* authenticate the login credentials passed to connectUser ( ) 

* by checking against username/pas sword stored in source file 
*/ 

private boolean authenticateUser (StoreProviderLogin login) 
{ 

if (! login. name . equals ( username )) return false; 

if {! login. password. equals ( password )) return false; 

System. out .println ( "TextFileProvider "+instanceNumber+" authenticates "+username) ; 
return true; 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Thinairapps Imports 

import thinairapps . groupware . api . * ; 

import thinairapps .groupware . api . actions . * ; 

import thinairapps .groupware . api . bounds . * ; 

import thinairapps .groupware . api . exception . * ; 

import com. thinairapps. platform. provider. *; 
import com. thinairapps .platform. exception. * ; 

import com.thinair.utils.*; 

//Standard Java Imports 
import java .util . * ; 



* @ {#) TextFileProvderContext 

* provides static information for and about the TextFileProvider 
*/ 

public class TextFileProviderContext extends StoreProviderContext 



// Version info 

protected static final String VERSION 
protected static String APP_NAME 
protected static final String MANUF_NAME 
protected static final String MANUF_CONT 
protected static final String BUILD 
protected static final Date APP_RELEASED : 

protected Properties props; 



"1.2"; 

"TextFileProvider" 

"ThinAirApps" ; 

" www . ThinAirApps . ci 

new Date ( ) ; 



* Determines if the context has optional user-editable properties. Implementors should 

* return true if they can offer optional Properties to the user, but do not require 

* properties to be set in order to correctly serve user connections. StoreProviders mayi^ 

have 

* both property types. 

* ©return A boolean indicating whether or not the context has optional properties. 
*/ 

public boolean hasOptionalProps ( ) { return false; } 



/** 

* @return ProviderObj ectSet indicating the friendly and class names of Storeltem ^ 

subclasses 

* understood by this StoreProvider . 
*/ 

public StoreProviderType getTypeO { return new StoreProviderType (" thinairapps . groupware . 
api " ) ; } 



/** 

* Called by a client to ask for product information on the provider. 

* ©return StoreProviderInf o containing information on this provider. 
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*/ 

public StoreProviderInf o getlnfo () 
{ 

return new StoreProviderInf o ( MANUF_NAME, 
MANUF_CONT , 
APP_NAME , 
VERSION, 
BUILD, 

APP_RELEASED ) ; 

} 



/** 

* Tells the context to update its property set. It will throw a 

SPInvalidContextPropsException 

* if it does not accept the properties. 

* @param props The new set of properties to commit. 
*/ 

public void updateProps (Properties p) 
{ 

if (p .getProperty ( "SourceFile" ) == null) 

throw new Runt imeExcept ion ( "Cannot find property SourceFile in provider.ini"); 



/** 

* ©return A boolean indicating whether or not the context can offer required properties. 
*/ 

public boolean hasReguiredProps ( ) { return true; } 



/** 

* Retireves a ContextProperties object containing user-editable required and optional 

* properties 

* ©return ContextProperties object containing user-editable required and optional 

properties . 

*/ 

public ContextProperties getPropsO 
{ 

Properties required = (props == null) ? new Properties () : (Properties) props. clone 
() ; 

return new ContextProperties ( new Properties () , required); 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Standard Java Imports 
import java .util . * ; 



/** 

* @(#) Tokenizer . java 

* Simple tokenizer that, unlike StringTokenizer , wil 

* String when two tokens appear right next to each c 
*/ 

public class Tokenizer 
{ 

private static final String BLANK = ""; 

private char DELIM; 

private int currentPosition,- 

private int maxPosition; 

private String str; 



* buld a new Tokenizer for the given String with the given delimiter 

* ©param s source String 

* ©param d delimiter character 
*/ 

public Tokenizer (String s, char d) 
{ 

str = S; 
DELIM = d; 

currentPosition = 0; 
maxPosition = str . length () ; 



* Returns the next token from this string tokenizer. 

* ©return the next token from this string tokenizer - may be ' 
DELIMs next to each other appear in the String 



*/ 



NoSuchElement Except i^ 
tokenizer 's string. 



public String nextToken ( ) 
{ 

int start = currentPosition; 

if (++currentPosition > maxPositi( 



if (currentPosition =: 
return BLANK ; 

// else.... 

if (str .charAt (start) 
while ( (currentPositi. 
current Posit ion++ 



; maxPosit: 



if there are 3 



n) throw new NoSuchElementException () ; 
II (str .CharAt (currentPosition) == DELIM)) 



(str. charAt (currentPosi- 



! = DELIM) ) 



return str . substring ( start , currentPosition) . trim () ; 

} 
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* Returns the same value as the <code>hasMoreTokens</code> 

* method. It exists so that this class can implement the 

* <code>Enumeration</code> interface. 

* ©return <code>true</code> if there are more tokens; 

* <code>f alse</code> otherwise. 

* ©see java.util. Enumeration 

* ©see java.util . StringTokenizer#hasMoreTokens ( ) 
*/ 

public boolean hasMoreTokens () 
{ 

return (currentPosition < maxPosition) ; 
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send Email sample Groupware Connector 
wireless SDK for ThinAir Server 



About This Sample 

This sample Groupware connnector is compatible with any of the ThinAir 
Groupware Providers included in the standard server installation. It 
demonstrates how to write a simple Connector using the ThinAir Groupware API 
that allows a user to create and send an email message. 

The send Email connector first displays a Ui prompting the user for the 
from, subiect, and body elements of the email message, it then reads the 
user's login credentials from the connector.ini file. The Connector could 
easily be modified to prompt for this information, as the Getitems Groupware 
Connector does. It then connects to the message store, creates a Groupware 
Obiect representing the email message, and sends it. it then logs the user 
off. This example could easily be modified to create items of other types, 
e.g. Event or Task. 

N.B. This sample connector is written for wml devices only. 



Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

* groupware. jar 

This sample does not require any other external APIs. 



Sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file 
sendltemsconnector. class - compiled Java code 
/src - java source files 



Building the sample 



Compile the sample code using the Java compiler of your choice. The included 
MAKE script will compile the sample using the JDK, if available. 

install the compiled sample code and connector.ini configuration file into a 
subdirector>/ of the ThinAir server's /connectors subdirectory, given a name 
of your choice. 

start the ThinAir server, it will load the sample code and begin executing it. 



using the sample 



wait until the Thi nAi rserver has started and the Send Email Groupware connector 
has been loaded and initialized. From a WML device, enter the IP address 
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README.txt 

listed as the value for Application path in connector.ini (your ThinAi rserver IP 
address), followed by /samples/sendemai 1 . For a machine with IP address 
111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/sendemai 1 

Follow the on-screen instructions. 



Last updated: 11.13.2000 
copyright 1999, 2000 ThinAi rApps Inc. 
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/** 

* @ (#) SendEmail Connect or . java 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 

import com. thinairapps .platform. device . * ; 
import com . thinairapps . platform. connector . * ; 
import com. thinairapps . platform. exception . * ; 
import com. thinairapps .platform. provider. * ; 

//rendering packages used to build markup 
import com. thinairapps . tag .* ; 
import com . thinairapps . tag . wral . * ; 

// the groupware packages 
I "import thinairapps . groupware . api . * ; 
jfimport thinairapps .groupware .api .actions . * ; 
, import thinairapps .groupware .api .bounds . * ; 
I' ^diiipo^t thinairapps .groupware .api . exception. * ; 



^Jimport java.util.* 
I 'import java.io.*; 



/** 

* This is a simple sample whose purpose is to illustrate the use of the ThinAir Groupware 

Library for creating groupware items. 

* This sample renders WML. It prompts the user to enter to address, a subject and a body, 

and then procedes 

* to log them onto their message store, create (send) the item and then log them off again. 

This sample could easily be 

* modified to create items of other types, eg. Event or Task 

* For a comprehensive reference of the Groupware Library see the ThinAir Groupware javadocs. 
public class SendEmailConnector implements Connector 



//The friendly name of this sample app 
protected String appName; 

//Our access point to the services of ThinAir Server 
protected ConnectorAccess connectorAccess ; 

protected String provider ,- 
protected String userName,- 
protected String password; 
protected String host; 
protected String f romDisplay ; 
protected String fromEmail; 

private final static String SUPPORTED_ITEMS_CACHE_KEY = "supports"; 



/** 

* initO is called by the ThinAirServer when the Connector is loaded. It provides the 
connector with 
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it needs to interact with the ThinAirServer . 

* For more information about the Connector interface, see the javadocs for the ThinAir kT 

Server API 

* ©param applicationName is a String derived from connector.ini. 

* ©param applicationPath is a String dervid from connector.ini. We don't need this for 

this sample. 

* Oparam connectorProps is a Properties list containing developer assigned \i 

connector-specific properties. 

* (Sparam connectorAccess is our access point to the services provided by ThinAir Server. 

* Oparam ApplicationLog is used for logging 
*/ 

public void init (String applicationName, String applicationPath, 

Properties connectorProps, ConnectorAccess connectorAccess, com. 

thinairapps .platform. connector .ApplicationLog al) throws ^ 
ConnectorlnitException { 
this.appName = applicationName; 
this . connectorAccess = connectorAccess ,- 

// get the all required variables from the properties list (connector.ini) . make surei^ 

you set this up before 
//running this example 

provider = connectorProps . getProperty { "Provider" ) ; 
// your user name 

userName = connectorProps .getProperty ( "UserName" ) ; 
// your password 

password = connectorProps .getProperty ( "Password" ) ; 

// the ip of your message host, note: if using IMAP or POP 

// the ip of the smtp server you will be using is in the providers provider.ini file 
host = connectorProps.getProperty("Host") ; 

// your display name 

fromDisplay = connectorProps .getProperty ( "FromDisplay" ) ; 
// your email address 

fromEmail = connectorProps .getProperty ( "FroraEmail" ) ; 

if (provider. length () == 0 | | userName . length ( ) == o | | password . length ( ) == o | | 
host.lengthO == 0 | | fromDisplay. length () == 0 | | fromEmail . length ( ) == 0) 
throw new ConnectorlnitException ( "connector . ini must have entries for Provider, 
UserName, Password, Host, FromDisplay, and FromEmail"); 



/**getDevices () is called once by the ThinAir Seirver during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used \t 

to uniquely 

* identify every DeviceProf lie . To get the friendly name of a particular device, refer kf 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName () method. 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this ^ 

Connector supports. 

*/ 

public String [] getDevicesO 
{ 

String deviceType = "TA_WAP"; 
string [] deviceTypes = {deviceType}; 
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/**The handle method implements the core logic of a Connector. It takes an incoming 
request from a 

* particular device, and returns an appropriate response. This method is called wheneveri^* 

the server 

* receives a request from a type of device that the Connector indicates it supports, \i 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of ^ 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much infor-mation as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed ^ 

information 

* on the capabilities of the particular device making the request. 

* Oparam props a set of name value pairs corresponding to the HTTP request parameters \£ 

from the device. 

* @param device a Device object created in the image of the actual device making this 

request . 

* ®param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle (Properties props, Device device, OutputStream result) throws ^ 
lOException { 

String resultString = null; 

//qet. the 'action' parameter from the request. This is an HTTP param we define to 

determine what action 

//to take when we get a request. 
String action = props . getProperty ( "action" } ; 

String sessionid = null ; 

if (action == null) 
{ 

// if this is the first hit (or any request for the main deck) 
// build a deck that lets the user enter information. 
resultString = renderCreateMesage ( ) ; 

} else if (action. equals ( "createMsg") ) 
{ 

// they have already entered the information, get the messages 
String to; 

String sub; 
string body,- 

// get the required parameters 

// the mail host we will be accessing fom the HTTP params 
// the recipient 

to = props . getProperty ( "tolnput ") ; 

// the message subject 

sub = props . getProperty (" sublnput ") ; 

// the message body 

body = props .getProperty ( "bodylnput" ) ; 

try 
{ 

//we have all the information we need to logon and send the message 
// log you in to teh message store 

sessionid = loginUser (provider , host, userName, password); 
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// get the default location from the supported Items returned from Login thatw? 

we stored in the session cache 
String def aultLocation = getDef aultLocation (ItemTypes .MESSAGE , sessionid) ; 

// send the message 

sendMessage (def aultLocation, sessionid, fromDisplay, fromEmail, to, sub, ^ 
body) ; 

// log them off 

connectorAccess .getStoreProvider (sessionid) .d: 



// now render a screen indicatii 
resultString = renderSuccess ( "Message Successfully Created"); 

catch (Exception e) 

// need to do error checking here, we simply display the error messac 
provide a link 

// back to the welcome screen, a larger app would handle each error 

seperatley and navigate the 
// user accordingly 

resultString = renderException (e . getMessage ( ) ) ; 



byte[] resultBytes = resultString .getBytes () ; 
result, write (resultBytes) ,- 



* This method logs the user in to their message store 

* ©param providerName the name of the provider being used to access the message store. 

* Oparam host the ip or server name of the message store. 

* ©param userName the user name of the account being logged onto. 

* ©param password the password for this user. 

* ©return a providerSessionID if success, otherwise an error will be thrown. 
*/ 

protected String loginUser (String providerName, String host. String userName, 
String password) throws Exception { 

String SID = null; 
try { 

// Create a new Session with the specified provider and returns a unique Sessioi 
ID. 

SID = connectorAccess . createProviderSess ion (providerName); 

// Get the StoreProviderProxy associated with the session we just created, 
// this is what is used to interact with the Provider 

StoreProviderProxy spProxy = connectorAccess . getStoreProvider (SID); 

// Create a StoreProviderLogin object, this defines the action the Provider wil 
execute 

StoreProviderLogin login = new StoreProviderLogin (userName, password, host) ; 

// use the StoreProviderProxy to login. The provider returns the items it 

supports and the actions on them 
Support edit ems supports = spProxy . connectUser (login); 

// we cache the supported Items because we know we will need them later 
connectorAccess .getSessionCache (SID) .put (SUPPORTED_ITEMS_CACHE_KEY , supports) ; 
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} catch (NoSuchProviderException e) { 

throw new Exception ( "No Provider named "+providerName+" was loaded by the ThinAiri^ 
Server" ) ; 

} 

return SID; 

} 



/** 

* This method sends a message. It assumes you are in the logged in state 

* @param location the location the message is to be created in, this does not matter 

when creating a message, however if creqating 

* a post or other item we could specify the location the item be placedkT 
in. 

* (Sparam SID a valid session Id, the user must already be authenticated. 

* ©param fromDisplay the items storelndex to start at, this may be null if starting at ^ 

the beginning 

* @param fromEmail the maximum number of messages to retrieve. 

* (Sparam to the recipient of the message you are sending. This can be their email ^ 

address, or you can have the server try and identify them either throught LDAP if ^ 
supported and activated or through the message stores internal name resolution system 

* ©param sub the subject of the message you are sending. 

* @param body the body of the message you are sending. 
*/ 

protected void sendMessage (String location, String SID, String fromDisplay, String 
fromEmail , 

String to, String sub. String body) throws Exception 

{ 

Message msg = new Message (); 

GroupwareUserSMTPAddress fromAddr = new GroupwareUserSMTPAddress (fromDisplay, 

fromEmail) ; 
msg . setFrom (fromAddr); 

// the recipients are always an array of GroupwareUserSMTPAddresss ' we are assuming 

for this example that there will only be one 
// feel free to tokenize a list of comma or serai-colon delimited list of recipients >e 

here 

GroupwareUserSMTPAddress [] toAddrs = new GroupwareUserSMTPAddress [ 1] ; 
if (to.indexOf ("@") > 0) 

// it is a valid email address 

toAddrs [0] = new GroupwareUserSMTPAddress (null , to); 

else 

// not a valid address, leave it up to the Provider or mesasge store to validate 
toAddrs [0] = new GroupwareUserSMTPAddress (to, null); 

msg . setRecipients (Message -RecipientType -TO, toAddrs) ; 

// if we suppported cc 
/* 

GroupwareUserSMTPAddress [] ccAddrs = new GroupwareUserSMTPAddress [1] ; 
if (to.indexOf ("@") > 0) 

ccAddrs[0] = new GroupwareUserSMTPAddress (null , cc) ; 

else 

ccAddrs[0] = new GroupwareUserSMTPAddress (cc , null); 

msg . setRecipients (Message . RecipientType . CC, ccAddrs) ; 
*/ 

msg . setSubject (sub) ; 
msg.setBody (body); 

// the location the message is to be created in, this does not matter when creating ai^ 
message, however if creating a 
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// post or other item we could specify the location the item be placed in. 
msg . setLocationlnStore (location) ; 

StoreProviderProxy spProxy = connectorAccess . getStoreProvider (SID) ; 

AddNewGroupwareltem addAction = new AddNewGroupwareltem (msg) ; 
spProxy.doUserDataAction (addAction) ; 



/** 

* A utility method that simply looks in the session cache for the Supportedltems, 

extracts the 

* default location for the specified item type and returns it 

* ©param SID a valid session Id. 

* ©param itemtype the type of item. 

* ©return the default location. 
*/ 

private String getDefaultLocation (int itemType, String SID) throws 
NoSuchSessionException 

{ 

// look for Supportedl terns in the cache 

Supportedltems sis = (Supportedltems) connectorAccess .getSessionCache (SID) .get 

(SUPPORTED_ITEMS_CACHE_KEY) ; 
Enumeration elem = sis .getltems ( ) ; 
Supportedltem si = null; 

// cycle through them until we find the type we need and return it 

while (elem.hasMoreElements () ) 

{ 

si = (Supportedltem) elem. nextElement () ; 

if (itemType == si .getType ( ) ) 

{ 

return si . getDef aultLocation ( ) ; 



//itemType not found, this should never happen 
return null; 

} 



/** 

* This method renders a deck with several cards including a welcome card and card for 

entering inf ozTtiation. . . 

* ©return the rendered deck. 
*/ 

private String renderCreateMesage ( ) 
{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create the first card in the deck and give it the ID 'cl' 
DisplayCard cardl = new DisplayCard ( "cl" ) ; 
//create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph. ALIGN_CENTER, Paragraph. MODE_WRAP) ; 



p.addChild(new TextC'Send Email")); 
p.addChild(new Break () ) ; 

p.addChild(new Text("Sample Connector")); 
//add the Paragraph to the card 
cardl . addParagraph (p) ; 
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p = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph .MODE_WRAP) ; 

//a link to the second card 
String href = "?#compose" ; 

//make a Go task with the href 

Go go = new Go (href , true , Go .METHOD_GET) ; 

//create the Anchor with the Go task 

Anchor anchor = new Anchor (go, new Text ( "Login" ) ) ; 

//add the anchor to the Paragraph 
p. addChild (anchor) ; 

//add the second Paragraph to the card 
cardl .addParagraph(p) ; 

//add the first card to the deck 
deck. addCard( cardl) ; 

Labeledlnput tolnput = new Label edinput (" to" , "TO:"); 
Labeledlnput sublnput = new Labeledlnput (" sub" , "SUBJECT:"); 
Labeledlnput bodylnput = new Labeledlnput ( "body" ,"BODy:"); 

Labeledlnput [] inputs = {tolnput, sublnput, bodylnput}; 

//set the URL params to the values in the WML variables fcamp;, the escape sequence 

for ampersand, delimits name- 
//value pairs. $ is used to dereference a WML variable. A random number is used so 

the next time you get to this page you will actually 
// be hitting the server rather that retrieving from the phone's cache 
href = "?action=createMsg&tolnput=$ (to) &sublnput=$ (sub) &bodyInput 

=$ (body) &rnd="+Math. random () ; 

MultiplelnputCard mic = new MultiplelnputCard ( "compose" ) ; 



mic.buildCard(href , "Send" , inputs, Go. METHOD_GET) ; 
deck. addCard (mic) ; 

String resultString = deck . render () ; 
return resultString; 



/** 

* This is a simple exception rendering method. 

* ©param message the message to be presented to the user 

* @return the rendered WML deck 
*/ 

private String renderException (String message) 
{ 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( ) ; 
Paragraph p = new Paragraph { ) ; 

p. addChild (new Text (message) ) ; 
p. addChild (new Break () ) ; 

String href = " ?rnd= " +Math . random () ; 

Go go = new Go(href ,true,Go.METHOD_GET) ; 

Anchor anchor = new Anchor (go, new Text ("Start again...")); 



p , addChi Id ( anchor ) 
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card. addParagraph (p) ; 
deck . addCard (card) ; 

String resultString = deck. render () ; 
return resultString; 

} 



* This is a simple rendering method indicating success. 

* ©param message the message to be presented to the user 

* ©return the rendered WML deck 
*/ 

private String renderSuccess (String message) 
{ 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCardO ; 
Paragraph p = new Paragraph ( ) ; 

p.addChild(new Text (message) ) ; 
p.addChild(new Break () ) ; 

String href = " ?rnd= " +Math . random () ; 

Go go = new Go (href , true, Go .METHOD_GET) ; 

Anchor anchor = new Anchor (go , new Text {"Start again...")); 

p. addChild (anchor) ; 

card . addParagraph (p) ; 
deck. addCard( card) ; 

String resultString = deck. render () ; 
return resultString; 
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Getltems sample Groupware Connector 
wireless SDK for ThinAir Server 



About this sample 



This sample Groupware Connnector is compatible with any of the ThinAir 
Groupware Providers included in the standard server installation. It 
demonstrates how to write a simple Connector using the ThinAir Groupware API 
that allows a user to log into their email store and retrieve messages. 

The Getltems Connector prompts the user for their email host, username, and 
password, if the login is accepted by the Groupware provider, the connector 
retrieves the first 5 messages in the user's inbox. This example could easily 
be modified to retrieve items of other types, e.g. Events or Tasks. 

N.B. This sample connector is written for wml devices only. 



Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

* groupware. jar 

This sample does not require any other external apis. 



sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file 
GetltemsConnector .class - compiled Java code 
/src - java source files 



Building the Sample 



Compile the sample code using the 3ava compiler of your choice. The included 
make script will compile the sample using the 3DK, if available. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 

start the ThinAir server, it will load the sample code and begin executing it. 



using the Sample 



wait until the Thi nAi rserver has started and the Get items Connector has been 
loaded and initialized. From a WML device, enter the IP address listed as the 
value for Appl i cati onPath in connector.ini (your Thi nAi rServer IP address), 
followed by /samples/geti terns. For a machine with IP address 111.222.12.34 
this would be: 

http ; //111 . 222 . 12 . 34/sampl es/geti terns 
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i-screen instructions. 



Last updated: 11.13.2000 
copyright 1999, 2000 ThinAirApps Inc. 
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* @ (#) Get Items Connector . java 

* Copyright (c) 2 000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE ^ 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com. thinairapps .platform. device . * ; 
import com. thinairapps .platform. connector . * ; 
import com. thinairapps . platform. exception . * ; 
import com. thinairapps -pi at form. provider . *; 

//rendering packages used to build markup 
import com. thinairapps . tag .* ; 
import com. thinairapps . tag . wml . * ; 

// the groupware packages 

import thinairapps . groupware . api . * ; 

import thinairapps . groupware . api . actions . * ; 

import thinairapps . groupware . api . bounds . * ; 

import thinairapps .groupware .api .exception. * ; 

' -Smpor t j ava . ut i 1 . * ; 
. import j ava . io . * ; 

/**This is a simple sample whose purpose is to illustrate the use of the ThinAir Groupware 
Library forn retrieving groupware Items. 
Oj* This sample renders WML. It prompts the user to enter a mail host, a userName and a 
password and then precedes 

* to log them onto their message store, retrieve the first 5 messages from the default 

location and render the 

111* headers. This sample could easily be modified to retrieve items of other types, eg. Event 
or Task, and render 

ip* For a comprehensive reference of the Groupware Library see the ThinAir Groupware javadocs. 
*/ 

public class GetltemsConnector implements Connector 
{ 

//The friendly name of this sample app 
protected String appName; 

//Our access point to the services of ThinAir Server 
protected ConnectorAccess connectorAccess ; 

//The provider 

protected String provider; 

private final static String SUPPORTED_ITEMS_CACHE_KEY = "supports"; 

// Max number of characters to be displayed in the subject portion of the header 

private final static int HEADER_SUBJECT_LENGTH = 10; 

// Max number of characters to be displayed in the from portion of the header 
private final static int HEADER_FROM_LENGTH = 11; 



/**init() is called by the ThinAirServer when the Connector is loaded. It provides the \^ 

* resources it needs to interact with the ThinAirServer . <br><br> 

* For more information about the Connector interface, see the javadocs for the ThinAir 

Server API 

* @param applicationName is a String derived from connector.ini. 
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* ©param applicationPath is a String dervid from connector . ini . We don't need this : 

this sample. 

* @param connectorProps is a Properties list containing developer assigned 

connector-specific properties. 

* ©param connectorAccess is our access point to the services provided by ThinAir Ser 

* ©param applicationLog is used for Logging 
*/ 

public void init (String applicationName , String applicationPath, Properties 
connectorProps , 

ConnectorAccess connectorAccess , com. thinairapps .plat form. connector . 
ApplicationLog al) throws ConnectorlnitException 

{ 



// get the provider name from the properties list (connector.ini) 

// You can modify this in connector.ini to access a different provider, to retrieve 
// items from a different mesage Store type, eg. IMAP or P0P3 
provider = connectorProps .getProperty( " Provider" ) ; 

if (provider. length {) == 0) throw new ConnectorlnitException ( "No Provider entry in 
connector . ini" ) ; 

} 



/**getDevices { ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing \£ 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getNameO method. 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports . 

*/ 

public String [] getDevicesO 
{ 

String deviceType = "TA_WAP" 
string!] deviceTypes = {deviceType},- 
return deviceTypes; 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming 
request from a 

* particular device, and returns an appropriate response. This method is called wheneverii' 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into ^ 

* The Connector can then utilize the particular Device class to determine more detailed u? 

information 

* on the capabilities of the particular device making the request. 
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■ @paraTn props a set of name value pairs 

from the device. 

■ ©pararn device a Device object created : 

request . 

• @param result a reference to the OutputSt 



public void handle {Properties props. Device device, OutputS' 
lOException 



irresponding to the HTTP request parameters 
the image of the actual device making this 
that will be returned to the device. 

result) throws 



String resultString = null; 

//get the 'action' parameter from the request. This is ai 
//determine what action to take when we get a request. 
String action = props .getProperty ( "action" ) ; 

String sessionid = null; 

if (action == null) 
{ 

// if this is the first hit (or any request for the t 
// build a deck that lets the user enter information 
resultString = renderLoginPrompt ( ) ; 



. HTTP param ^ 



get the message; 



else if (action . equals ( "msgs ") ) 
{ 

// they have already entered the informati' 
String host; 
String userName; 
String password; 

// the mail host we will be accessing fom the HTTP params 
host = props. getPropertyC'host") ; 



: props. getPropertyC'usr") ; 



// and password 

password = props .getProperty ( "pwd" ; 



// make sure they have entered all information 
if (host==null II host. length ()==0 || userName==null 
II password==null || password . length ()==0) 



userName .length ()==0 



// if they haven't, tell them what they did wrong. 

resultString = renderException ( " You must enter all information"); 



//we have all the information we need to logon 



try 
{ 

sessionid = loginUser (provider , host, userName, password); 

// get the default location from the supported Items returned from Login ^ 

that we stored in the session cache 
String def aultLocation; 

def aultLocation = getDefaultLocation(ItemTypes .MESSAGE, sessionid); 
/* 

In this simple example we only retrieve items from the default 
location, however ThinAir Groupware Providers provide 

a means to query a store for the available locations, then use that ^ 
location to retrieve items from. This method can 

be used to access Exchange public and private folders, as well as 
IMAP. 
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// Get the locations 

UserDataLocationReguest udLocReq = new UserDataLocationRequest () ; 
//udLocReq. itemType = itemTypeParamToCode (itemType) ; 
udLocReq. itemType = ItemTypes .MESSAGE ; 

udLocReq. maxDepth =0; // how many folders deep do we want to go?, ai^ 
depth of more than 0 will include sublocation marked by the 
' / ' charactger 

UdLocReq. maxLocat ions = -1; 

udLocReq. rootLocation = rootLocation ; // null if starting from the 



UserDataLocations udLocations = connectorAccess . getStoreProvider 
(sessionld) . getLocations (udLocReq) ; 

String locations[] = udLocations .getNames () ; 

// now we have an array of other locations, you may use one of these ^ 
to retrieve items from. 



*/ 

// get the messages 

Storeltems messages = getStoreltems (def aultLocatipn, sessionld, null, 5, ^ 
ItemTypes. MESS AGE) ; 

// log them off 

connectorAccess .getStoreProvider (sessionld) . disconnectUser { ) ; 
// then delete the session 

connectorAccess . deleteSession ( sessionld) ; 



/ / now render them 

resultString = renderMessageHeaders (messages) ; 

// in this example we logged on, got the messages then logged off again. ^ 

A more complete app would 
// hold the session open between requests, and cache the retrieved ^ 

Storeltems in the session cache, using this to 
// feed item bodies out to the client without going to the provider each wf 

time 



} 

catch (Exception e) 
{ 

// need to do error checking here, we simply display the error message 
and provide a link 

// back to the welcome screen, a larger app would handle each error uf 

separately and navigate the 
// user accordingly 

resultString = renderException (e . getMessage ( ) ) ; 

} 



byte[] resultBytes = resultString .getBytes () ; 
result -write (resultBytes) ; 

} 



* This method renders a deck with several cards including a welcome card and a card for 

entering information. . . 

* @param providerName the name of the provider being used to access the message store. 

* @param host the ip or server name of the message store. 

* ©param userName the user name of the ccount being logged onto. 

* @param password the password for this user. 

* oreturn a providerSessionId if success, otherwise an error will be thrown. 
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*/ 

protected String loginUser (String providerName , String host. String userName, 
String password) throws Exception { 

String SID = null; 

try 
{ 

// Create a new Session with the specified Provider and returns a unique Session \e 
ID. 

SID = connectorAccess . createProviderSession (providerName) ,- 

// Get the StoreProviderProxy associated with the session we just created, 
// this is what is used to interact with the Provider 
StoreProviderProxy spLite = connectorAccess .getStoreProvider (SID); 

// Create a StoreProviderLogin object, this defines the action the provider will 
execute 

StoreProviderLogin login = new StoreProviderLogin (userName, password, host) ; 

// use the providerProxy to login. The provider returns the itens it supports 
Supportedl terns supports = spLite . connectUser (login); 

//we cache the supported Items because we know we will need them later 
connectorAccess .getSessionCache (SID) .put (SUPPORTED_ITEMS_CACHE_KEY, supports) ; 

} 

catch (NoSuchProviderException e) 
{ 

throw new Exception ( "No Provider named "+providerName+ " was loaded by the ThinAiri^ 
Server" ) ; 

} 

return SID; 

} 



/** 

* This method retrieves storeltems from the Provider. There is no cache involved here. 

* This same method can be used to retrieve any item type, starting at a particular item \l 

id, 

* up to a max number. 

* ©param location the location or folder items are to be retrieved from. 

* ©param SID a valid session Id, the user must already be authenticated. 

* @param startldx the items storelndex to start at, this may be null if starting at the i^" 

beginning 

* ©param max the maximum number of messages to retrieve. 

* ©param itemtype the type of item to retrieve. 

* ©return the storeltems, this will be of length 0 if no items are retrieved, never nullii< 

except if exception thrown 

*/ 

protected Storeltems getStoreltems (String location. String SID, String startldx, int maxi^ 
, short itemtype) throws Exception 

{ 

ItemRequest iReg = new IteraReguest () ; 

iReq. itemType = itemtype; 

iReq. itemLocation = location; 

iReq. max = max; 

iReq.startID = startldx; 

iReq . bounds = nul 1 ; 

UserDataRequest udReq = new UserDataRequest (); 
udReq . requests = new ItemRequest [1] ; 
udReq. requests [0] = iReq; 

// getting items of another type we shoud check in the supportedltems to verify they ^ 

are supported by the current Provider 
storeltems storeltems = (Storeltems) connectorAccess . getStoreProvider (SID) . ^ 
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/** 

* A utility method that simply looks in the session cache for the Support edi terns , 

extracts the 

* default location for the specified item type and returns it 

* @param SID a valid session Id. 

* @parain itemtype the type of item. 

* (greturn the default location. 
*/ 

private String getDef aultLocation (int itemType, String SID) throws 
NoSuchSe s s ionExcept ion 

{ 

// look for Supportedltems in the cache 

Supportedl terns sis = (Supportedltems) connectorAccess .getSessionCache (SID) .get y[ 

(SUPPORTED_ITEMS_CACHE_KEY) ; 

Enumeration elem = sis .getltems ( ) ; 
Supportedl tern si = null; 

// cycle through them until we find the type we need and return it 

while (elem.hasMoreElements 0 ) 

{ 

si = ( Supportedl tern) elem. nextElement 0 ; 

if (itemType == si.getTypeO) 

{ 

return si .getDef aultLocation () ; 




//itemType not found, this should never happen 
return null; 

} 



/** 

* This method renders a deck with several cards including a welcome card and card for \i 

entering login information... 

* (Sreturn the rendered deck. 
*/ 

private String renderLoginPrompt () 
{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( > ; 

//create the first card in the deck and give it the ID ' cl ' 
DisplayCard cardl = new DisplayCard ( "cl" ) ; 

//create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph .ALIGN_CENTER, Paragraph .MODE_WRAP) ; 

p.addChild(new Text ("Get Items")); 
p.addChild(new Break () ) ; 

p.addChild(new Text("Sample Connector")); 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph(Paragraph.AIjIGN_LEFT, Paragraph. MODE_WRAP) ; 



//a link to the second card 
String href = "?#c2"; 
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//make a Go task with the href 

Go go = new Go (href , true, Go .METHOD_GET) ; 

//create the Anchor with the Go task 

Anchor anchor = new Anchor (go, new Text ( "Login" )) ; 

//add the anchor to the Paragraph 
p . addChild (anchor) ; 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the first card to the deck 
deck . addCard ( cardl ) ; 

// create a new Mult iplelnput Card and give it the ID 'c2' This allows the user to kf 

type in information 
MultiplelnputCard card2 = new MultipleInputCard( "c2 " ) ; 

// host name input 

Labeledlnput host = new Labeledlnput ( "host "Host :") ; 

// set the input text to lowecase by deafult 
host . setFormat ( " *m" ) ; 

// username input 

Labeledlnput userName = new Labeledlnput ( "usr" , "Username :") ; 
userName . setFormat ( " *m" ) ; 

// pasword input 

Labeledlnput password = new Labeledlnput ( "pwd" , "Password :") ; 

password. setFormat (" *m" ) ; 

//display input characters as stars... 

password . setType (Input . TYPE_PASSWORD) ; 



Labeledlnput [] inputs = {host, userName, password}; 

//set the URL params to the values in the WML variables &, the escape sequence wT 

for ampersand, delimits name- 
//value pairs. $ is used to dereference a WML variable. 

href = "?action=msgs&color=$ (color) &host=$ (host) &pwd=$ (pwd) &usr 
= $ ( us r ) Siamp ; rnd= " +Math . random ( ) ; 



//build the card with the href, "Submit" as the button label, the array of Inputs, 

and the method specified. 
card2 .buildCard(href , "Submit" , inputs. Go .METHOD_GET) ; 

deck.addCard(card2) ,- 

String resultString = deck . render () ; 
return resultString,- 



* This method renders a deck with one card containing the message headers if any, else ^ 

an error message explaining no messages available. 

* ©param msgs the messages to render. 

* ©return the rendered deck. 
*/ 

public String renderMessageHeaders (Storeltems msgs) 
{ 

//create the deck 
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WMLTagDocument deck = new WMLTagDocument ( ) ; 

if (msgs . size ( ) == 0) 
{ 

// no messages available for display 
DisplayCard card = new DisplayCard ("errl"," 
card.buildCard ("There are no messages in this f older" , Paragraph .ALIGN_CENTER) ; 
deck.addChild (card) ; 



// there are messages, go ahead and render them. . 
String url = null ; 

int msgldx; 

string titleText = ( (Message) msgs . elementAt (0) ) .getLocationlnStore () ,- 
if (titleText == null) 

titleText = "INBOX"; 

//create the first card in the deck and give it the ID 'cl' 
DisplayCard card = new DisplayCard ( "cl" ) ; 

Paragraph p = new Paragraph (Paragraph .ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 

p.addChild(new Text (titleText)); 

p.addChild(new BreakO); 
card . addParagraph (p) ; 

Paragraph p2 = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 

// add the message items 
Message msg; 

for (int i = 0; i < msgs. size {); i++) 
{ 

msg = (Message) msgs. elementAt (i) ; 

// display an image if the phone supports it 

p2 .addChild(new Image(new Icon (Icon. ENVELOPED , Image .ALIGN_MIDDLE, null) ) ; 

//get the subject text, shorten if necessary 
String subText = "no subject"; 

if (msg.getSubject () != null && msg . getSubj ect (). length ( ) > 0) 
{ 

subText = msg.getSubject 0 ; 

if (subText. length () > HEADER_SUBJECT_LENGTH) 

subText = subText. substring (0,HEADER_SUBJECT_LENGTH- 3) + "..."; 



subText = ReservedCharacter. reformat (subText); 

} 

p2 .addChild(new Text (subText) ) ; 



//get the from text, shorten if necessary 
String fromText = "no sender"; 
if (msg.getFromO != null) 



fromText = msg . getFrom ( ) . getAddress ( ) ; 
if (fromText != null) 



(fromText. length 0 > HEADER_FROM_LENGTH) 
fromText = fromText . substring (0, HEADER_FROM_LENGTH) ; 
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else if (frottiText . length C) > HEADER_FROM_LENGTH) 

fromText = fromText . substring (0, HEADER_FROM_LENGTH) ; 

} 

p2.addChild(new Text (fromText) ) ; 
p2 . addChild (new Break () ) ; 

} 

p2 . addChild (new Break () ) ; 



// link home. 

String href = "? rnd= " +Math . random { ) ; 

Go go = new Go(href , true,Go.METHOD_GET) ; 

Anchor anchor = new Anchor (go , new Text ("Start again...")); 

p2 .addChild (anchor) ; 

card.addParagraph(p2) ; 
deck.addCard (card); 

} 

return deck . render ( ) ; 



/** 

* This is a simple exception rendering method. 

* @param message the message to be presented to the user 

* ©return the rendered WML deck 
*/ 

private String renderException (String message) 
{ 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( ) ; 
Paragraph p = new Paragraph ( ) ; 

p. addChild (new Text (message) ) ; 
p. addChild (new Break ( ) ) ; 



String href = "?rnd="+Math.random() ; 

Go go = new Go (href , true, Go .METHOD_GET) ; 

Anchor anchor = new Anchor (go, new Text ("Start again...")); 

p. addChild (anchor) ; 

card. addParagraph (p) ; 
deck.addCard (card) ; 

String resultString = deck . render () ; 
return resultString; 

} 



README . tXt 



Customltem sample Groupware Connector 
Wireless SDK for ThinAir Server 



About this sample 



This sample Groupware Connnector demonstrates how to write a simple Connector 
using the ThinAir Groupware API that allows a user to log in to their 
groupware store, and retrieve an item with custom fields, or add a new item 
with custom fields. Of the Providers shipped with the ThinAir Server, the 
Domino and Exchange Providers both support custom item handling. 

The Customltem connector first has the user log into the groupware store, 
using login data entered in the connector.ini file. The Connector can easily 
be modified to prompt for this information, as the Getltems Groupware Connector 
does. If the login is accepted by the Groupware Provider, the Connector prompts 
the user to choose one of two actions: either retrieving the first message in 
the user's specified folder, or adding a new item in the user's specified 
folder. 

The location of the custom items folder must be specified in the connector.ini 
file. For accessing an Exchange store, only the Folder value need be specified. 
To access a Domino store, both the Folder and the Database values must be 
specified, since Domino uses a database/folder scheme to store data. To specify 
a Domino database, use the file name (which ends with ".nsf") for the database, 
'mot the Notes name. 

This example can easily be modified to retrieve several items at once, or to 
perform other Groupware actions (such as moving, updating and deleting), see 
the other Groupware samples for more information on how to interact with 
jhinAir Groupware Providers. 

«ote: This sample Connector is written for wml devices only. 



Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

* groupware. jar 

This sample does not require any other external apis. 



Sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file 
CustomitemConnector. class - compiled Dava code 
/src - java source files 



Building the Sample 



compile the sample code using the Dava compiler of your choice. The included 
MAKE script will compile the sample using the jdk, if available. 

install the compiled sample code and connector.ini configuration file into a 
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subdirectory of the ThinAir Server's /connectors subdirectory, given a name 
of your choice. 

Start the ThinAir Server, it will load the sample code and begin executing it. 



using the Sample 



wait until the Thi nAi rserver has started and the customitems connector has been 
loaded and initialized. From a WML device, enter the IP address listed as the 
value for ApplicationPath in connector.ini (your Thi nAi rserver IP address), 
followed by /samples/custom. For a machine with IP address 111.222.12.34 this 
would be: 

http://lll. 222 . 12 . 34/sampl es/custom 
Follow the on-screen instructions. 



Last updated: 11.17.2000 
copyright 1999, 2000 ThinAirApps Inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com. thinairapps . platform. * ; 
import com. thinairapps . platform. device . * ; 
import com. thinairapps .platform. connector . * ; 
import com. thinairapps . platform . exception . * ; 
import com. thinairapps .platform. provider. * ; 

//rendering packages used to build markup 
import com. thinairapps. tag.*; 
import com . thinairapps . tag . wml . * ; 

// the groupware packages 

import thinairapps . groupware . api . * ; 

import thinairapps . groupware . api . actions . * ; 

import thinairapps . groupware . api . bounds . * ,- 

import thinairapps. groupware. api. except ion.* ; 

import j ava . util . * ; 
import j ava . io . * ; 

'/**This sample illustrates the use of the Customltem type to handle data in custom-created 

* folders and databases . 

* This sample renders WML. It prompts the user to choose one of two actions: add (create a 

* item in the specified folder) , or read (get the field names and values in the first item 

* within that folder, and display a group of them on the screen) . 

* The login data (provider name, host name, username, password) , the name of the template/ 

form for 

* the custom item folder, the name of the folder and (for a Lotus Domino item) the name of 

the 

* database, are all specified within the connector. ini file. 

* For a comprehensive reference of the Groupware Library see the ThinAir Groupware javadocs. 
*/ 

iipublic class CustomltemConnector implements Connector 
{ 

// The friendly name of this sample app 
protected String appName; 

// Our access point to the services of ThinAir Server 
protected ConnectorAccess connectorAccess ; 

// The application log 

protected com. thinairapps . platform, connector .ApplicationLog log,- 

/ / The provider 

protected String provider; 

// The user's login data 

protected String host, userName, password; 

// The location of the custom item folder within the Groupware store. 
// This should not be a global variable in a real connector, 
protected String location; 

// The name of the form/template that this custom folder uses - 

// this variable is not actually used in any of this connector's code; however, 
//it was included because it would be used by any real connector dealing with 
// Customltems, to add new items. See the comments within the addCustomltem ( ) 
// method for details 
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protected String fomiName; 

protected String sessionld = null; 

private String ACTION_FIELD = "action" ; 
private String LOGIN_ACTION = "login"; 
private String CREATE_ACTION = "add" ; 
private String READ_ACTION = "read"; 



/** 

* initO is called by the ThinAirServer when the Connector is loaded. It provides the i^' 

connector with 

* resources it needs to interact with the ThinAirServer. 

* For more information about the Connector interface, see the javadocs for the ThinAir \i 

Server API 

* ©param appIicationName is a String derived from connector.ini. 

* ©param applicationPath is a String derived from connector.ini. We don't need this fori^' 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned 

connector-specific properties. 

* (gparam connectorAccess is our access point to the services provided by ThinAir Server. 
*/ 

public void init (String appIicationName, String applicationPath, Properties ^ 
connectorProps , 

ConnectorAccess connectorAccess, com. thinairapps .platform. connector . 
ApplicationLog appLog) throws ConnectorlnitException 

{ 

this.appName = appIicationName; 

this . connectorAccess = connectorAccess; 

log = appLog; 

// the two strings from connector.ini that we'll use to create the official 
==l // "location" string 

String folder, database; 

// get provider name, as well as all login data, location of the custom folder, and 
// the name of the form/template being used, from the properties list (connector.ini) 
// Make sure you set up all necessary information before running this example, 
provider = connectorProps . get Property (" Provider ") ; 

if (provider. length 0 == 0) throw new ConnectorlnitException ( "No Provider entry in 
host = connectorProps .getProperty ( "Host ") ; 

if (host . length ( ) == 0) throw new ConnectorlnitException ( "No Host entry in connector, 
userName = connectorProps. getProperty ("UserName") ; 

if (userName . length ( ) == 0) throw new ConnectorlnitException ( "No UserName entry in 
connector.ini") ; 

password = connectorProps .getProperty ( "Password" ) ; 

if (password. length ( ) == 0) throw new ConnectorlnitException ( "No Password entry in 
connector . ini " ) ; 

folder = connectorProps . getProperty (" Folder" ) ; 

if (folder . length ( ) == 0) throw new ConnectorlnitException ( "No Folder entry in 
connector . ini " ) ; 

database = connectorProps .getProperty ( "Database" ) ; 

// no exception thrown if user didn't include the name of the database - this may or kT 
may 

// not be a necessity for the groupware store being accessed. In the case of the ^ 
groupware 

// providers that come with the ThinAir Server, the Domino provider requires one, ^ 
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while the 
// Exchange provider doesn't 



// now, set the location string - if no database name was included, then location 
// will just be equal to the folder name 
if (database. length 0 == 0) 
( 

location = folder; 

} 

else 
{ 

//a database name was included; since we have only a single String to represent 
// the location within the eventual data request, how do we get both the folder 
// and the database name into this one String? Thankfully, there's a utility in 
// the Customltem class that takes care of it for us 

location = Customltem. LocNameUtils.createLocationString (database, folder); 

} 

formName = connectorProps .get Property ("FormName") ; 

// no exception thrown if user didn't include the name of the folder's form/template; 
// a Customltem connector can function without it, although not as well 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a b<r 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf lies supported by this Connector. These names are the friendly names used uT 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getNameO method. 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports. 

*/ 

public String [] getDevicesO 
{ 

String deviceType = "TA_WAP" ; 
String [] deviceTypes = {deviceType}; 
return deviceTypes ; 



/**The handle method implements the core logic of a Connector. It takes an incoming u! 
request from a 

* particular device, and returns an appropriate response. This method is called wheneveri^ 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 

* ©param props a set of name value pairs corresponding to the HTTP request parameters 
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from the device . 

* ©param device a Device object created in the image of the actual device making this 

request . 

* @param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle (Properties props, Device device, OutputStream result) throws 
lOException 



String resultString = null; 

//get the 'action' parameter from the request. This is an HTTP param we define to 

determine what action 
//to take when we get a request. 

String action = props .getProperty (ACTI0N_FIELD) ; 

try 
{ 

if (action == null) 
{ 

// if this is the first hit (or any request for the main deck) , build a 
// deck that lets the user specify which action to run 
resultString = renderStartScreen ( ) ; 

} 

else if (action. equals (LOGIN_ACTION') ) 
{ 

sessionid = loginUser (provider , host, userName, password) ,- 
resultString = renderOptionMenu ( ) ; 

} 

else 
{ 

if (action. equals {CREATE_ACTION) ) 
{ 

addCustomltem (location, sessionid) ; 

resultString = renderMes sage ( "Item successfully added!"); 

} 

else if (action. equals (READ_ACTION) ) 
{ 

Customltem item = getCustoraItem( location, sessionid) ; 

//render the fields of this object 
resultString = renderCustomltemFields (item) ; 

} 

// log off the user 

connectorAccess.getStoreProvider (sessionid) .disconnectUser { ) ; 
// then delete the session 

connectorAccess . deleteSession ( sessionid) ; 

) 

} 

catch (Exception e) 
{ 

e . printStackTrace ( ) ; 

// Here, we employ a primitive solution of simply displaying the error message 

and providing a link 
// back to the welcome screen; a larger app would handle each error separately 

and navigate the 
// user accordingly 

resultString = renderMessage (e . getMessage ( ) ) ; 

} 

// in this example we logged on, performed a simple action, then logged off again. A 
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more 

// complete app would hold the session open between requests, and cache the retrieved 
// Storeltems in the session cache, using this to feed item bodies out to the client 
// without going to the provider each time 

byte[] resultBytes = resultString . getBytes ( ) ; 
result -write (resultBytes) ; 

] 



/**loginUser ( ) logs in the user to a groupware store using the specified login data 

* ©param providerName the name of the provider being used to access the message store. 

* ©param host the IP or server name of the message store. 

* (Sparam userName the user name of the account being logged onto. 

* @param password the password for this user. 

* ©return a providerSessionId if success; otherwise an error will be thrown. 
*/ 

protected String loginUser (String providerName, String host. String userName, 
String password) throws Exception 

{ 

String SID = null; 

try 
{ 

// Create a new Session with the specified provider and returns a unique Session 
ID. 

SID = connectorAccess . createProviderSession (providerName); 

// Get the providerProxy associated with the session we just created, 
// this is what is used to interact with the Provider 
StoreProviderProxy spLite = connectorAccess .getStoreProvider (SID); 

// Create a StoreProviderLogin object, this defines the action the provider will \t 
execute 

StoreProviderLogin login = new StoreProviderLogin (userName, password, host) ; 

// use the providerProxy to login. The provider returns the items it supports 
Supportedltems supports = spLite . connectUser (login) ,- 

// check to make sure that this provider handles Customltem objects 

boolean supportsCustltems = false; 

Enumeration supportedEnum = supports .getltems () ; 

while ( supportedEnum. hasMoreElements 0 ) { 

Supportedltem curltem = ( Supportedl tern) supportedEnum. nextElement () ; 

if (curltem.getType () == ItemTypes . CUSTOM_ITEM) 
supportsCustltems = true; 

} 

// if it doesn't handle Customltem objects, throw an exception 
if (! supportsCustltems) 

throw new Exception ( "Specif ied provider (" + providerName + ") does not \Z 
support Customltem handling") ; 

} 

catch (NoSuchProviderException e) 
{ 

throw new Exception ( "No Provider named " + providerName + " was loaded by the \i 
ThinAir Server") ; 

} 

return SID; 

} 



/**getCustomItem() retrieves the first item from a groupware location, and returns a 
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* Customltem object containing all its information 

* ©param location The location in the groupware store being accessed 

* ©param SID The session ID for the user's connection to the groupware store 

* ©return a Customltem representing the first item in the folder 
*/ 

protected Customltem getCustomltem (String location, String SID) throws Exception 
{ 

String resultString ; 

ItemRequest iReq = new ItemRequest ( ) ; 
iReq. itemType = ItemTypes . CUSTOM_ITEM; 
iReq. itemLocation = location; 
iReq. max = 1; 
iReq.startID = null ; 
iReq. bounds = null; 

UserDataRequest udReq = new UserDataRequest () ; 
udReq. requests = new ItemRequest [1] ; 
udReq. requests [0] = iReq; 

UserData uData = connectorAccess .getStoreProvider (SID) .getUserData (udReq) ; 
ItemRequestResponse irr = uData . responses [0] ; 
Storeltems customltems = irr. items; 

// we got back customltems; get the first element out (which is all 
// we requested) 

return (Customltem) customltems. elementAt (0) ; 



/**addCustomItem() adds an item to a groupware location containing custom- 

* definted items 

* Oparam location The location in the groupware store being accessed 

* ©param SID The session ID for the user's connection to the groupware store 
*/ 

protected void addCustomltem (String location. String SID) throws Exception 

// In order to add a new item and populate its fields, we have to know 

// what the names of its fields are. If this were a real application, 

// we'd already know ahead of time what all the fields are named, and could 

// thus prompt the user for the values of those fields we wanted to populate. 

// The code would look something like: 

// Customltem custltem = new Customltem ( formName ) ; 

// custltem. addField(importantFieldl, importantFieldlUserValue) ; 

// custltem. addField(importantField2, importantField2UserValue) ; 
// ...etc. 

// However, because this is a generic sample, we don't know what any 

// of the fields will be ahead of time. The following code, thus, is a 

// hack: we create a Customltem object that has the properties of the 

// first item in this folder, using the getCustomltem ( ) method. This 

// object now has all the fields that the items in the folder being 

// accessed contain (or at least all but the standard item fields - 

// see the discussion below) . We then go through each of the fields and 

// set them to a new value, depending on their type. We then create 

// the item. 

Customltem custltem = getCustomltemdocation, SID) ; 

// let's loop through the fields in this new item and set some values 

// get an enumeration of all the custom fields 

Enumeration fieldEnum = custltem. getCustomFieldData () .getFields () ; 



while (fieldEnum. hasMoreElements ( ) ) 
{ 
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//get the next field 

Field thisField = (Field) fieldEnura. nextElement () ; 
if (thisField.getNameO .lengthO > 0) { 

String fieldName = thisField. getName () ,- 

//check the type 

if (thisField.getTypeO == Field. BOOLEAN_VAL) 

//set all booleans to true 
thisField. set (true) ; 

else if (thisField.getTypeO == Field. DOUBLE_VAL) 

//set all doubles to be 123.123 
thisField. set (123. 123) ; 

else if (thisField.getTypeO == Field . INT_VAL) 

//set all ints to 123 
thisField. set (123) ; 

else if (thisField.getTypeO == Field. LONG_VAL) 

//set all longs (this will include currency values) to 123.45 
thisField. set (123 .45) ; 

else if (thisField.getTypeO == Field. STRING_VAL) 

thisField. set ( "New String!"); //set all strings to "New String!" 
else if (thisField.getTypeO == Field . DATE_VAL) 

//set all dates to current time 

thisField. set (new Date (System. currentTiineMillis O ) ) ; 




// That took care of all the custom fields. It may not have, however, taken care 
// of all the standard item fields, those fields that were present in the groupware 
// store template that this folder's form/template was derived from (if, in fact, it 
// was derived from another template) . If we wanted to access these standard fields, 
// we would do: 

// Storeltem standardltem = item.getstandardltera( ) ,- 

// Then you could treat standardltem like any other groupware Storeltem; 
// see the other groupware connector samples for more on how to manipulate standard \t 
items 

// set the location of the new item to be the user- specif led location 
custltem. setLocationlnStore (location) ; 

StoreProviderProxy spProxy = connectorAccess . getStoreProvider (SID); 

AddNewGroupwareltem addAction = new AddNewGroupwareltem(custltem) ; 

spProxy . doUserDataAction (addAction) ; 
return; 

} 



/**This method renders a deck containing a welcome card 
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* ©return the rendered deck. 
*/ 

private String renderStartScreen ( ) 
{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID 'cl' 
Display-Card cardl = new DisplayCard ( " cl " ) ; 

//create a centered Paragraph 

Paragraph p = new Paragraph {Paragraph .ALIGN_CEWTER, Paragraph .MODE_WRAP) , • 

p.addChild(new Text ( "Custom Items")); 
p.addChild{new BreakO); 

p.addChild(new Text ("Sample Connector")); 

//add the Paragraph to the card 
cardl. addParagraph(p) ; 

p = new Paragraph ( Paragraph. ALIGN_LEFT, Paragraph. MODE_WRAP) ; 
// links to the two possible actions 

String loginHref = "?" + ACTION_FIELD + "=" + LOGIN_ACTION + '"&rnd=" + Math. 
random ( ) ; 

// Go task for the href 

Go loginGo = new Go ( loginHref , true , Go .METHOD_GET) ; 
// Anchor for the Go task 

Anchor loginAnchor = new Anchor (loginGo, new Text ( "Login" )) ; 

//add the anchors to the Paragraph 
p. addChild (loginAnchor) ; 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the card to the deck 
deck. addCard( cardl) ; 

String resultString = deck . render ( ) ; 
return resultString; 



/**This method renders a deck with a card that lets the user specify which action to take 

* ©return the rendered deck . 
*/ 

private String renderOptionMenu ( ) 
{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID 'cl' 
DisplayCard cardl = new DisplayCard ( "cl ") ; 
//create a centered Paragraph 

Paragraph p = new Paragraph(Paragraph.ALIGN_CENTER, Paragraph. MODE_WRAP) ; 

p.addChild (new TextC'Custom Items")); 
p. addChild (new BreakO); 

p. addChild (new Text("Sample Connector")); 

//add the Paragraph to the card 
cardl .addParagraph (p) ; 

p = new Paragraph{Paragraph.ALIGN_LEFT, Paragraph. MODE_WRAP) ; 
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// links to the two possible actions 

String createHref = "?" + ACTION_FIELD + "=" + CREATE_ACTION + "&rnd=" + Math. 
random ( ) ,- 

String readHref = "?" + ACTION_FIELD + "=" + READ_ACTION + "&rnd=" + Math, random i/" 
{) ; 

// Go tasks for the two hrefs 

Go createGo = new Go (createHref , true , Go . METHOD_GET) ; 
Go readGo = new Go (readHref , true , Go. METHOD_GET) ; 

// Anchors for the two Go tasks 

Anchor createAnchor = new Anchor (createGo, new Text ("Create a new item")); 
Anchor readAnchor = new Anchor (readGo, new Text ("Read first item")); 

//add the anchors to the Paragraph 
p . addChild (createAnchor) ; 
p. addChild( readAnchor) ; 

//add the second Paragraph to the card 
cardl.addParagraph(p) ; 

//add the card to the deck 
d€ck.addCard(cardl) ; 

String resultString = deck . render () ; 
return resultString; 



/**This method renders a deck with one card containing the first 15 fields in 

* the Customltem. 

* Oparara item the Customltem whose fields we should render 

* ©return the rendered deck. 
*/ 

public String renderCustomltemFields (Customltem item) 
{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
String url = null; 

.//create the first card in the deck and give it the ID 'cl' 
DisplayCard card = new DisplayCard ( " cl " ) ,- 

Paragraph p = new Paragraph (Paragraph .ALIGN_LEFT, Paragraph .MODE_NOWRAP) ; 

p. addChild (new Text ("Custom Item")); 

p. addChild (new Break ()) ; 
card. addParagraph (p) ; 

Paragraph p2 = new Paragraph ( Paragraph .ALIGN_LEFT , Paragraph . MODE_NOWRAP) ; 
// Now add the fields and their values 

//first get the Data object that conatins all the info about our custom fields. 
Data customFields = item . getCustomFieldData ( ) ; 

//we can get an enumeration of the fields... 
Enumeration fieldEnum = customFields .getFields () ; 

// go through the fields, and add each one to the deck - we'll stop after 15, 
//to avoid any deck overflow problems 
int itemsDisplayed = 0; 

while (f ieldEnum.hasMoreElements ( ) && itemsDisplayed < 15) 
{ 
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String fieldText = null; 

Field thisField = (Field) fieldEnum. nextElement {) ; 



/you must check the type 

f (thisField. getTypeO == Field. BOOLEAN_VAL) 



fieldText = thisField . getName {)+ " 
else if (thisField.getTypeO == Field 
fieldText = thi sField. getName () +" 
else if (thisField.getTypeO == Field 
fieldText = thisField. getName () +" 
else if (thisField.getTypeO == Field 
fieldText = thisField. getName () +" 
else if (thisField.getTypeO == Field 
fieldText = thisField.getName () +" 
else if (thisField.getTypeO == Field 
fieldText = thisField.getName ()+ " 



p2 .addChild(new Text ( fieldText) ) ; 
p2 .addChild(new Break () ) ; 
■ , t emsD i spl ayed+ + ; 



" + thisField. getBoolean O ; 
DOUBIjE_VAL) 
" + thisField. getDouble 0 ; 

INT_VAL) 

" + thisField. getint 0 ; 
LONG_VAL) 

" + thisField. getLiong () ; 
STRING_VAL) 

" + thisField. getString 0 ; 

DATE_VAL) 

+ thisField. getDate O ; 



} 



// link home. 

String href = " ?rnd="+Math. random 0 ; 

Go go = new Go (href , true , Go .METHOD_GET) ; 

Anchor anchor = new Anchor (go, new Text ("Start agai) 



p2.addChild( anchor) ; 



card.addParagraph(p2) ; 
deck.addCard (card) ; 



return deck . render ( ) ; 



/** This method renders a simple message, either an error or a success, 

* then links back to the main page 

* ©param message the message to be presented to the user 

* Oreturn the rendered WML deck 
*/ 

private String renderMessage (String message) 
{ 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
DisplayCard card = new DisplayCard ( ) ; 
Paragraph p = new Paragraph () ; 

p.addChild(new Text (message )) ; 
p.addChild(new Break O ) ; 



String href = " ?rnd= " +Math . random () ; 

Go go = new Go (href , true,Go.METHOD_GET) ; 

Anchor anchor = new Anchor (go , new Text ("Start again...")); 



p. addChild (anchor) ; 
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card.addParagraph(p) ; 
deck. addCard (card) ; 

String resultString = deck. render () ; 
return resultString; 



README.txt 



WML Rendering Sample Connector 
Wireless SDK for ThinAir Server 



About this Sample 

This sample Connector demonstrates the use of the WML Tag library to accept 
input from WML forms and render output for WML Browsers. 



Requi rements 

This sample requires the following SDK jars: 

* platform. jar 

* tag! ib. jar 

This sample does not require any other external APIs. 



'sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file. 
WMLSamplesConnector. class - compiled Java code 
/src - the Java source file, WMLSampleConnector. java 



' Building the sample 

■compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your CLASSPATH. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /connectors subdirectory, given a name 
of your choice. 

Start the ThinAir server, it will load the sample code and begin executing it. 



using the sample 

wait until the ThinAi rserver has started and the WML Rendering Connector has 
been loaded and initialized. From your WML device, enter the IP address listed 
as the value for ApplicationPath in connector.ini (your Thi nAi rServer IP 
address), followed by /samples/wml . For a machine with ip address 
111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/wml 

Follow the on-screen instructions. 

Last updated: 11.13.2000 
copyright 1999, 2000 ThinAirApps inc. 

Page 1 



README . txt 



Page 2 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com . thinairapps . platform . connector . * ; 
import com. thinairapps .platform. device . * ; 

//Rendering packages used to build markup 
import com. thinairapps . tag .* ; 
import com. thinairapps . tag .wml .* ; 

//Core Java API 
import java.util.*; 
import java.io.*; 



/** 

* This is a simple sample whose purpose is to illustrate the use of the ThinAir WML Tag 

* Library. It creates two simple WML decks: the first prompts the user for their favorite \i 

color, 

* username and password, the second simply echos the submitted values. This sample makes 

* use of SelectlnputCard, MultiplelnputCard, DisplayCard, Do, Go, Anchor, Paragraph, Text, wf 

and Break . 

* For more information on use of the WML Tag Libraries, see the Tag Library documentation ^ 

and the ThinAir 

* Server Development Guide. 
*/ 

■public class WMLSampleConnector implements Connector 

//Declare variables global to this Connector 
String appName; 
ConnectorAccess access,- 
String appPath; 



/** 

* initO is called by the ThinAirServer when the Connector is loaded. It provides the 

Connector with 

* resources it needs to interact with the ThinAirServer. 

* ©param applicationName is a String derived from connector.ini. We don't need this fork? 

this sample. 

* ©param applicationPath is a String dervid from connector.ini. We don't need this for \l 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned ^ 

connector-specific properties. 

* We don't need this parameter in this sample. 

* ©param connectorAccess is our access point to the services provided by ThinAir Server \^ 

We don't need this for this sample. 

* @param applicationLog is used for Logging. We do not use this in this sample 
*/ 

public void init (String applicationName, String applicationPath, Properties 

connectorProps, ConnectorAccess connectorAccess, ApplicationLog applicationLog) 

{ 

appName = applicationName; 
access = connectorAccess; 
appPath = applicationPath; 



/** 

* getDevicesO is called once by the ThinAir Server during start-up. It allows 
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Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing u? 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used \l 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer wf 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getNameO method. 

* For more details about device detection and handling see the DeviceDetective sample <^ 

connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this y[ 

Connector supports . 

*/ 

public String [] getDevicesO 
{ 

String deviceType = "TA_WAP"; 
String [] deviceTypes = {deviceType}; 
return deviceTypes; 



/** 

* The handle method implements the core logic of a Connector. It takes an incoming 

request from a 

* particular device, and returns an appropriate response. This method is called whenever 

the server 

* receives a request from a type of device that the Connector indicates it supports, ^ 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of \^ 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 

* @param props a set of name value pairs corresponding to the HTTP request parameters 

from the device. 

* ©param device a Device object created in the image of the actual device making this ^ 

request . 

* ©param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle (Properties props, Device device, OutputStream result) 
{ 

String resultString = null; 

//Get the 'action' parameter from the request. 

//This is an HTTP param we define to determine what action to take when we get a 

String action = props . getProperty ( "action" ) ; 

//If this is the first hit 

if (action == null) 

{ 

//Build a deck that lets the user enter information. 
resultString = renderWelcome () ; 

} 

//If they have already entered the information, then display it 

else if (action. equals ("display") ) 

{ 

//Build a display deck with the entered info, pass the request propertxes m 
resultString = renderAnswers (props) ; 

} 
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hyteU resultBytes = resultString .getBytes () ,- 

try 

{ 

result -write {resultBytes) ,- 

} 

catch (lOException e) 

System. err. printlnC'Error! Unable to write to result OutputStream. " ) ; 

} 



/** 

* This method renders a deck with several cards including a welcome card and card for 

entering information 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server / 

Development Guide . 

* ©return the rendered deck. 
*/ 

private String renderWelcome ( ) 
( 

//Create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create the first card in the deck and give it the ID 'cl' 
DisplayCard cardl = new DisplayCard ( "cl " ) ; 

//Create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph. ALIGN_CENTER, Paragraph. MODE_WRAP) ; 

p.addChild(new Text ("Render WML")); 
p.addChild(new Break ()) ; 
p . addChild (new Text ( "Welcome " ) ) ; 
p.addChild(new Break ()) ; 

//Add the Paragraph to the card 
cardl .addParagraph(p) ; 

p = new Paragraph(Paragraph.ALIGN_LEFT, Paragraph. MODE_WRAP) ,- 

//A link to the second card 
String href = appPath + "?#c2"; 

//The go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (href , true , Go . METHOD_GET) ; 

//The anchor element anchors a task to a string of formatted text. This is often 

called a link. 
Anchor anchor = new Anchor (go , new Text ( "Next ")) ; 

//Add the anchor to the Paragraph 
p. addChild (anchor) ; 

//Add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//Add the first card to the deck 
deck.addCard( cardl) ; 

//Create a second card, give it the ID ' c2 ' 
Select InputCard card2 = new SelectlnputCard { "c2 " ) ; 

//SelectlnputCards gives the user a choice list 
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//Create all the choices and make "OK" the button label for all of these 

//A single letter (i.e. 'r', 'o', 'y' etc) will be the value assigned to 

//the variable in order to keep the size of the transmission down 

Option red = new Option ( "OK" ," r" , "Red" ) ; 

Option orange = new Option ( "OK" , "o" , "Orange" ) ; 

Option yellow = new Option ( "OK" , "y" , "Yelow" ) ; 

Option green = new Option ( "OK" , "g" , "Green" ) ; 

Option blue = new Option { "OK" , "b" , "Blue" ) ; 

Option indigo = new Option ( "OK" , "i" , "Indigo" ) ; 

Option plaid = new Option ( "OK" , "p" ," Plaid" ) ; 

//Make an array of all the options 

Option [] options = {red, orange, yellow, green, blue, indigo, plaid}; 

//Build the card. Link it to card 3 (c3), set the prompt to be "Favorite color;", 
set 

//the variable name for this choice to be "color", then set the allignment and 
wrapping 

card2 .buildCard{ "#c3 " , "Favorite color: " , "color" , options, Paragraph. ALIGN_LEFT, 
Paragraph.MODE_NOWRAP) ; 

//Add the SelectlnputCard 
deck . addCard ( card2 ) ; 

//Create a new MultiplelnputCard and give it the ID ' c3 ' 
MultiplelnputCard cardB = new MultiplelnputCard ( "c3 ") ; 

//This allows the user to type in information 

Labeledlnput userName = new Labeledlnput ( "usr" , "Username : " ) ; 

//This sets the input text to lowecase by default though the user can change it 
userName . setFormat ( " *m" ) ; 

Labeledlnput password = new Labeledlnput ( "pwd" , "Password: ") ; 
password. setFormat ("*m") ; 

//This will display input characters as stars 
password. setType (Input . TYPE_PASSWORD) ; 

Labeledlnput [] inputs = {userName, password} ; 

//Set the URL params to the values in the WML variables 
//&, the escape sequence for ampersand, delimits name- 
//value pairs. $ is used to dereference a WML variable. 

href = appPath + " ?action=display&arap ; color=$colorS;amp ; usr=$usrS;amp ; pwd=$pwd&amp ; rnd 
= " +Math . random ( ) ; 

//Build the card with the href, "Submit" as the button label, the array of Inputs, 

and the method specified. 
card3 .buildCard(href , "Submit" , inputs, Go .METHOD_GET) ; 
deck. addCardC cards) ; 

//Render the deck 
return deck . render () ; 



private String renderAnswers ( Properties props) 
{ 

//Get the arguments passed from the welcome deck 
String usrName = props . getProperty ( "usr ") ; 
String password = props . getProperty ( "pwd" ) ; 

//This will be a single letter, so we have to map it to a color 
String color = props . getProperty ( "color" ) ; 
if (color == null) 

return renderExcept ion ( "Error ! No color was entered."); 
if (color. equals ( "r") ) 
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color = "Red" ; 
else if (color. equals { "o" ) ) 

color = "Orange"; 
else if (color . equals ( "y" ) ) 

color = "Yellow"; 
else if (color. equals ("g") ) 

color = "Green" ; 
else if (color .equals ( "b") ) 

color = "Blue"; 
else if (color . equals ( "i" ) ) 

color = "Indigo"; 
else if (color- equals ( "p" ) ) 

color = "Plaid"; 

//Create the deck 

WMLTagDocument deck = new WMLTagDocument { ) ; 

//Create the first card in the deck and give it the ID ' cl ' 
DisplayCard cardl = new DisplayCard { "cl " ) ; 

//Create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph .ALIGN_LEFT, Paragraph . MODE_WRAP) ; 

//Display the values 
p.addChild(new Text (color) ) ; 
p.addChild(new Break () ) ; 
p.addChild(new Text (usrName) ) ; 
p . addChild (new Break ( > ) ; 

//Show the password for this sample. In general, of course, this is not recommended 
p. addChild (new Text (password) ) ; 
cardl . addParagraph (p) ; 

//We add a random number to prevent unwanted caching by some browsers 
String href = appPath + " ?rnd="+Math. random (} ; 

//The go element is a task element that instructs the device to open a specified URL. 
//We pass an href with no action, this will bring us to the welcome page 
Go go = new Go (href , true) ; 

//This will make a button with the label 'Main' 

Do dew = new Do (Do. TYPE_ACCEPT, go, "Main" , "main" , false) ; 

//Add the button to the card 
cardl. addChild (dew) ; 

//Add the card to the deck 
deck. addCard( cardl) ; 

//Render the deck 
return deck . render () ; 

} 



* This is a simple exception rendering method . 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For \£ 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server 

Development Guide . 

* ©param message the message to be presented to the user 

* ©return the rendered WML deck 
*/ 

private String renderException (String message) 
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{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard ( ) ; 

//Create a new paragraph 
Paragraph p = new Paragraph ( ) ; 

p.addChild(new Text (message) ) ; 
p.addChild(new Break () ) ; 

//Create the URL 

String href = appPath + "?rnd="+Math.random( ) ; 

//The go element is a task element that instructs the device to open a specified URL. 
Go go = new Go(href ,true,Go.METHOD_GET) ; 

//The anchor element anchors a task to a string of formatted text. This is often 
called a link. 

Anchor anchor = new Anchor (go, new Text ("Start again ...")) ; 

//Add the anchor to the paragraph 
p.addChild(anchor} ,- 

//Add the paragraph to the card 
card.addParagraph(p) ; 

//Add the card to the deck 
deck. addCard (card) ; 

//Render the deck 
return deck . render () ; 



README.txt 



Profile Management sample connector 
wireless SDK for ThinAir server 



About this Sample 



This sample Connector demonstrates how to take advantage of ThinAir Server's 
Profile Management features, in the ThinAir server architecture, user profiles 
are server-wide, password-protected records that are available to all 
connectors. A Connector can store application-specific data within the User 
Profile, and query the profile for data such as the user's known Devices. 

in this simple example the 'Connector prompts the user for a number and stores 
it in their User Profile as application data. The Connector then displays this 
information to the user. 

This connector also makes use of session objects. For more information on 

sessions, see the sessionManagement sample Connector in this directory and the 
corresponding ThinAir Server API documentation. 

N.B. This sample connector is written for WML devices only. 



Requi rements 

iThis sample requires the following SDK 3ARs: 

* platform. jar 

* taglib.jar 

This sample does not require any other external apis. 



Sample Files 

irhis sample consists of the following file tree: 
connector.ini - connector configuration file 
Profileconnector. jar - compiled Java code 

/src - java source files - Profileconnector. java and Profileoata. java 



Building the sample 



compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /connectors subdirectory, given a name 
of your choice. 

Start the ThinAir Server, it will load the sample code and begin executing it. 



Using the Sample 



wait until the ThinAi rserver has started and the Profile Management connector 
has been loaded and initialized. From your WML device, enter the IP address 
listed as the value for ApplicationPatn in connector.ini (your Thi nAi rserver 
IP address), followed by /samples/profile. For a machine with IP address 
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111.222.12.34 this would be: 

http : //111 . 222 . 12 . 34/sampl es/p rof i 1 e 
Follow the on-screen instructions. 



Last updated: 11.13.2000 
Copyright 1999, 2000 ThinAirApps Inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//This is a simple class which is the container for user profile data 
import java. io.Serializable; 



public class ProfileData implements Serializable 
{ 

public String f avoriteNumber ; 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality- 
import com. thinairapps .platform. connector . * ; 
import com. thinairapps .platform. device . * ; 
import com. thinairapps .platform. exception . * ; 

//Rendering packages used to build markup 
import com. thinairapps . tag. * ; 
import com . thinairapps . tag .wml . * ; 

//Core Java API 
import java . util . * ; 
import j ava . io . * ; 



/**This example illustrates how to user ThinAir Server's Profile management features. 

* Because Profiles are usually most effective and useful in stateful applications, 

* this example also makes use of sessions as well. For more information on using 

* sessions, see the SessionConnector sample, the ThinAir Server API documentation, 
13* and the ThinAir Server Development Guide. 

The ThinAir Server creates a password-protected User Profile for each user of the 
= system so the user must first log in. This User Profile is identified by a globally 
'■'=1* unique ID (the ThinAir User ID) . User Profiles include information about which 
JE* devices a user owns, which applications have been accessed by users and any application 
l,f specific data (such as the back-end server account information) . ThinAir Server 
;-~^;* administrators have control over all User Profiles through the User Manager tool 
'=1* that allows them to view all Profiles and add or remove users from both individual 
ffi* applications and the ThinAir Server itself. 

The Profile Connector follows a standard design pattern for ThinAir Connectors that 
require user profiles. Once users log in, they are then shown a menu with various 
01* application features presented as options. In this simple example, users can set a 
f'l* favorite number and store it in their profile. In subsequent screens, they can then 
;i=* view it. Returning users are handled in one of two ways depending on whether they have 
^^^* a device GUID. If the user has a device GUID, then the application looks up their User 
C3* Profile based on that GUID and they don't have to log in each time that they access the 
application. Returning users without a device GUID are forced to enter in their User ID 

* (which corresponds directly to their UserProf ilelD internally) in order for the i<r 

application 

* to recognize them (i.e. in order for them to have access to their User Profile) . 
*/ 

public class Prof ileConnector implements Connector 
{ 

//Declare variables global to this Connector 
String appName; 
ConnectorAccess access; 
String appPath; 

//We'll use this as the param name for user profiles 

public final static String USER_PROFILE_ID_ARG = "userProf ilelD " ; 

//This will be the param name for passwords 

public final static String USER_PROFILE_PWD_ARG = "pw" ; 

//The param name for the favorite number 

public final static String FAVORITE_NUMBER = "num" ; 



/**init() is called by the ThinAirServer when the Connector is loaded. It provides the 
* Connector with resources it needs to interact with the ThinAirServer. 
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* Oparara applicationName indicates the friendly name of this Connector application. 

* It is a String derived from connector.ini and this sample does 

* utilize it. 

* ©param applicationPath is the path to this Connector application. 

* It is a String derived from connector.ini and this sample does 

* utilize it. 

* ©paratn connectorProps is a Properties object containing developer assigned, ^ 

connector- specif ic 

* properties. It is derived froni connector.ini and this sample ^ 
does not 

* utilize it. 

* ©param connectorAccess is the one-and-only interface a Connector obtains to gain \^ 

access to 

* the runtime services (such as session and user profile ^ 
management ) 

* offered by the ThinAir Server to running Connectors. This 
sample uses 

* it to create a profile and store and retrieve data from the 
session cache. 

* @param appLog is used for Logging 
*/ 

public void init (String applicationName, String applicationPath, Properties \/ 
connectorProps, ConnectorAccess connectorAccess, com. thinairapps .platform. connector, 
ApplicationliOg appLog) 

{ 

appName = applicationName; 
access = connectorAccess; 
appPath = applicationPath; 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the 

* names of all DeviceProf iles supported by this Connector. These names are the friendlyiiT 

* used- to uniquely identify every DeviceProf ile . To get the friendly name of a 

particular device, 

* refer to the ThinAir Server Developer Guide or call DeviceProf ile ' s getNameO method. 

* For more details about device detection and handling see the DeviceDetective sample i^r 

Connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this 

Connector supports . 

*/ 

public String [] getDevicesO 
{ 

String deviceType = "TA_WAP"; 
String[] deviceTypes = {deviceType}; 
return deviceTypes; 



/**The handle method implements the core logic of a Connector. It takes an incoming 
request 

* from a particular device, and returns an appropriate response. This method is called 

* the server receives a request from a type of device that the Connector indicates it 

* supports, destined (as indicated in the request URL) for a specific application. It is 

* the responsibility of the Connector to interpret the request and generate an 

appropriate 

* response. 
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* The seirver will pass a Device object containing as much information as possible into «r 

this 

* method. The Connector can then utilize the particular Device class to determine more 

detailed 

* information on the capabilities of the particular device making the request. 

* @param props is a set of name value pairs corresponding to the HTTP request parameters vfT 

from 

* the device. 

* ©param device is a Device object created in the image of the actual device making thisi^r 

request . 

* @param result is a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle {Properties props. Device device, OutputStream result) 

//within the renderLogin method, we name the sessionID parameter in the URL "sid". 
//We get the value here. 

String sessionID = props .getProperty (" sid" ) ; 

//Find out what action the user is trying to perform 
String action = props .getProperty ( "action" ) ; 

//The User Profile is identified by a globally unique ID (the user's ThinAir User ID) 
String userProf ilelD = null; 

//The page to be rendered 
String resultString = null; 

//The cache for this session 
Hashtable cache = null; 

//If this is the user's first hit, they will not yet have a session 

if (sessionID == null) 

{ 

//So create one for them 

sessionID = access . createSession () ; 

} 

//ThinAir Server administrators have control (through the User Manager tool) over 
whether 

//password authentication is required for each application running on the ThinAir i^' 
Server . 

boolean mustAuthenticate = true; 

//Here we check if the session needs to be authenticated 
try 

mustAuthenticate = access . userAuthenticat ionRequiredForSession (appName , 
sessionID) ; 

} 

//Handle the case where the session has timed out 
catch (NoSuchSessionException e) 

renderExcept ion ( "Your session has timed out. Please re- register .") ; 

) 

//If the ThinAir Server administrator has not required password authentication, then 
he or she 

//is allowing known devices to logon automatically, 
if ( ! mustAuthenticate) 

//Get the device GUID, getGuidO returns null for those devices that don't have i*' 
GUIDs 

String deviceOUID = device .getGUID () ; 

//If the device has a deviceGUID and the userProf ilelD still hasn't been assigned 

if (userProf ilelD == null && deviceGUID != null) 

{ 

//Look up a User Profile ID from a Device GUID 
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//This userProf ilelD will later be used to both set and retrieve User ProfilekT 
information 

userProf ilelD = access .getUPIDFroitiDeviceGUID (deviceGUID) ; 

} 

//If the user has not performed an action and userProf ilelD is still null, then they \l 

need to login 
if (action == null && userProf ilelD == null) 

resultString = renderLogin ( sessionID) ; 

//If we have their userProf ilelD from their deviceGUID and there is no action 

performed by the user 
else if (action == null && userProf ilelD != null) 
{ 

try 
{ 

//Set the session as authenticated 
access . setSessionAuthenticated(sessionID, true) ; 

//Gets the caller-modifiable cache for a specified session, 
cache = access .getSessionCache (sessionID) ; 

//Place the userProf ilelD in the cache 
cache. put (USER_PROFILE_ID_ARG, userProf ilelD) ; 

//Render the menu 

resultString = renderMenu (sessionID) ; 

} 

//Handle an expired session 
catch (NoSuchSessionException e) 
{ 

resultString = renderExcept ion ( "Your session has timed out. Please \l 
re-register. " ) ; 



= null && action. equals ( "main" ) ) 

resultString = renderMenu ( sessionID) ; 
/Change the profile data 

Ise if (action != null && action. equals ( "update" ) ) 

resultString = updateProfileData (props , sessionID); 

/Show the profile data 

:lse if (action != null && action. equals ( "show" ) ) 



resultString = renderShowNumber ( sessionID) ; 

ull && action. equals ( "login" ) ) 
ultString = login(props, device); 



. renderSetNumber( sessionID) ; 



/Render for the device by turning the String into an array of bytes 
byte resultBytes [] = resultString. getBytes () ; 



//Write the bytes to the output stream 
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result .write (resultBytes) ; 

} 

catch (lOException e) 
{ 

System . err . println ( "Error ! cannot write to result OutputStream. " ) ; 

} 



* This method renders a deck to allow the user to enter a User ID and password. 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server i^' 

Development Guide. 

* ©param sessionID the unique sessionID for the user. 

* ©return A String containing the WML deck to be display to the user. 
*/ 

private String renderLog in (String sessionID) 
{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//The data will be sent to the server by means of a POST so no $variables need to be 
set in the URL 

//Build the URL. . . 

//Some devices cache content more than they should. Adding a random parameter is an 
unbeautif ul , 

//though often necessary technique for tricking the phone into always hitting the \^ 

server rather 
//than getting a page from its local cache. 

//n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require 1/ 

the absolute 
//application path so we include it here 

String url = appPath+ "?action=login& sid="+ sessionID + "&rnd=" + Math . randomwr 
0 ; 

//Create a display card 

Card card = new Card ( "ul" , "Welcome" ) ; 

//The Go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (url , true , Go .METHOD_POST) ; 

Labeledlnput userName = new Labeledlnput {USER_PROFILE_ID_ARG, "text" , "*m" , "User ID:"); 
Labeledlnput password = new Labeledlnput (USER_PROFILE_PWD_ARG, "password","* 1^ 

m" , "Password: " ) ; 
Labeledlnput [] inputs = {userName, password} ; 

//Add the post fields 

for (int i = 0; i < inputs . length; i++) 

go.addChild(new PostField ( inputs [i] .getlnputName (),"$ " + inputs [i] .getlnputName 
0 ) ) ; 

//Create a Do element that associates a task with an element within the user \^ 
interface . 

//When the user invokes the user interface mechanism, the device performs the >^ 

associated element task. 
Do dew = new Do (Do . TYPE_ACCEPT , go) ; 

dew . addAttribute ( " label " , "Next " ) ; 

//Add the Do element to the card 
card. addChild (dew) ; 

//Create a Paragraph 
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Paragraph p = new Paragraph ( ) ; 
//Add text to the paragraph 

p.addChild(new Text ( "Welcome to the Profile Connector")); 
p.addChildCnew Break () ) ; 

for (int i = 0 ; i < inputs . length ; i++) 
p. addChild{ inputs [i] ) ; 

//Add the paragraph to the card 
card.addChild(p) ; 

//Add the card to the deck 
deck. addChild (card) ; 

//Render the deck 
return deck . render {) ; 



/** 

* This generates the main menu deck. The menu gives the user thg option to either set 

their 

* favorite number or view it. This method is first called after login. 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server nr 

Development Guide. 

* (Sparam sessionID - the unique session ID for the user. 

* @return A String containing the WML deck to be display to the user. 
*/ 

private String renderMenu (String sessionID) 
{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard ( ) ; 

//Create a Paragraph 
Paragraph p = new Paragraph ( ) ; 

p. addChild (new Text ("Menu") ) ; 
p. addChild (new BreakO); 
p. addChild (new BreakO ) ; 

//Build the URL. . . 

//Some devices cache content more than they should. Adding a random parameter is an i^- 
unbeautiful , 

//though often necessary technique for tricking the phone into always hitting the 
//than getting a page from its local cache. 

//n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require \^ 

the absolute 
//application path so we include it here 

String href = appPath+ " ?action=set" + "&sid=" + sessionID + "&rnd=" + Math. ^ 
random ( ) ; 

//The Go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (href , true , Go .METHOD_GET) ; 

//The Anchor element anchors a task to a string of formatted text. This is often ^ 

called a link. 
Anchor a= new Anchor (go, new Text ("Set Number")); 
p. addChild (a) ; 
p. addChild (new BreakO ) ; 
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//This is the action that will occur when the link is selected 

href = appPath+ " ?action=show" + "&sid=" + sessionID + "&arap,-rnd=" + Math. random \e 
() ; 

//The second link 

go = new Go (href , true , Go . METHOD_GET) ; 
//Create the second link 

a= new Anchor (go , new Text ("Show Number")); 
p.addChild(a) ; 
p.addChildlnew Break ()) ; 

//Add the Paragraph to the card 
card.addParagraph(p) ; 

//Add the card to the deck 
deck .addCard (card) ; 

//Render the deck 
return deck, render () ; 

} 



/** 

* This method updates User Profile Data after the user has entered a new number. 

* ©param props - The Properties object containing the request parameters. 

* (Sparam sessionID - The user's unique session ID 
*/ 

private String updateProfileData (Properties props, String sessionID) 
{ 

Hashtable cache = null; 
String userProf ilelD = null; 

//Get the number from the URL 

String newNumber = props .getProperty (FAVORITE_NUMBER) ; 

//if the number is null, then fill it in 
if (newNumber == null) 

newNumber = "Not Set"; 

try 
{ 

//Get the session cache 

cache = access. getSessionCache (sessionID) ; 

//Get the userProf ilelD from the session cache 
userProf ilelD = (String) cache . get (USER_PROFILE_ID_ARG) ; 

//Get the old data from the profile 

ProfileData data = (Prof ileData) access . getUserProfileData (userProf ilelD, appName) ; 

if (data != null) 

{ 

/ /Set the value to the newly entered number 
data. favoriteNumber = newNumber; 

} 

else 
{ 

//Create a new profile data container 
data = new Prof ileData () ; 

//And fill it with our new number 
data . favoriteNumber = newNumber; 

} 

//Set the profile data to our profile data container object 
access . setUserProf ileData (userProf ilelD, appName, data) ; 

//Bring the user directly to the display deck 
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return renderShowNumber (sessionID) ; 

//Handle the case where the UserManager has changed permissions on this app 
catch (AddAppDataPermissionException e) 

return renderException ( "The Add Application Data Permission has been turned off kf 
for this application") ; 

//Handle the possibility of a time-out 
catch (NoSuchSessionException e) 

return renderException { "Your session has timed out. Please re-register."); 

//Handle the possibility that the profile no longer exists, 
catch (NoSuchUserProf ileException e) 

return renderException ( "Your Profile has been deleted. Please reregister or ^ 
contact your administrator."); 

//Handle the possibility that the administrator is using UserManager right now 
catch (Prof ileStoreLockedException e) 

return renderException ( "The profile store cannot be updated because the Profile kT 
store is locked. Please try again or contact your administrator."); 



/** 

* renderShowNumber creates the markup document that displays the number. It is either \^ 

called 

* when the user selects 'show number' from the main menu or after the user has set the \£ 

number . 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For \t 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server ^ 

Development Guide . 

* ©param sessionID the unique ID for this user's session. This will be displayed to thei^ 

* ©return A String containing the WML deck to be display to the user. 
*/ 

private String renderShowNumber (String sessionID) 
{ 

Hashtable cache = null; 
String userProf ilelD = null; 
String number = null; 
try 

{ 

//Get the session cache 

cache = access .getSessionCache (sessionID) ; 

//Get the User Profile ID from the session cache 
userProfilelD = (String ) cache . get (USER_PROFILE_ID_ARG) ; 

ProfileData data = (Prof ileData) access .getUserProfileData (userProf ilelD, appName) ; 

//The data has not yet been set 
if (data == null) 

number = "Not Set"; 

else 

number = data . favor iteNumber; 

} 

catch (NoSuchSessionException e) 

return renderException ( "Your session has timed out. Please re-register."); 

} 
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//Handle the rare case where the profile has been deleted by someone during our 
session 

catch (NoSuchUserProf ileException e) 
{ 

return renderException ( "Your profile has been removed. Please re-register or ^ 
contact your administrator."); 

} 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard ( ) ; 

//Create a Paragraph 
Paragraph p = new Paragraph ( ) ; 

//Display the user's sessionID 

p.addChild(new Text ("Your number is: "+ number)); 
//Build the URL. . . 

//Some devices cache content more than they should. Adding a random parameter is an 
unbeautiful, 

//though often necessary technique for tricking the phone into always hitting the 

server rather 
//than getting a page from its local cache. 

//n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require 

the absolute 
//application path so we include it here 

String href = appPath+ " ?action=main" + "&sid=" + sessionID + "S;amp;rnd=" + Math, 
random {) ; 

//The go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (href , true,Go .METHOD_GET) ; 

//Create a do element that associates a task with an element within the user 
interface . 

//When the user invokes the user interface mechanism, the device performs the ^ 

associated element task. 
Do dew = new Do(Do.TYPE_ACCEPT,go) ; 

p.addChild (dew) ; 

/ /Add the Paragraph to the card 
card. addParagraph (p) ; 

//Add the card to the deck 
deck. addCard( card) ; 

//Render the deck 
return deck . render { ) ; 

} 



/** 

* This is a simple card that renders a user interface that allows the user to set a 

number 

* that will be saved in the user's User Profile. 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For 

more 

* information on use of the Tag Libraries, see the Tag Library documentation and the 

* ThinAir Server Development Guide. 

* Oparam sessionID the uniques ID for the user's session. 

* ©return A String containing the WML deck to be display to the user. 
*/ 

private String renderSetNumber (String sessionID) 



: \TASS\ ■ ■ \General\UserProf ileManagement\src\Prof ileConnector ■ java 10 

{ 

//Create a WML deck 

WMLTagDocutnent deck = new WMLTagDocument ( ) ; 
//Create a display card 

MultiplelnputCard card = new MultiplelnputCard ( ) ; 

//Create a Paragraph 
Paragraph p = new Paragraph!) ; 

//set the action 
//Build the URL. . . 

//Some devices cache content more than they should. Adding a random parameter is an wT 
unbeautif ul , 

//though often necessary technique for tricking the phone into always hitting the 

server rather 
//than getting a page from its local cache. 

//n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require 

the absolute 
//application path so we include it here 

String href = appPath+ "?action=update& " + "sid=" + sessionID + "&rnd=" + 
Math.randomO + "&"+ FAVORITE_NXMBER + "=$ " +FAVORITE_NUMBER; 

//*N means that only numbers can be entered 

Labeledlnput number = new Labeledlnput (FAVORITE_NUMBER, "text" , "*N" , "Pick a number: "); 
Labeledlnput [] inputs = {number}; 

card.buildCard(href , "submit" , inputs , Go . METHOD_GET) ; 

//Add the card to the deck 
deck . addCard (card) ; 

//Render the deck 
return deck. render () ; 

} 



/** 

* The login method gets called after the user has entered their user ID and password. If 

the 

* userProf ilelD they entered already exists, it tries to authenticate the password. If 

the 

* password is wrong, it returns an error saying that this is the case. If the password 

* is correct, it stores the userProf ilelD in the session cache for future use, sets 

* the session to be authenticated and renders the main menu. 

* If the userProf ilelD the user entered does not exist, then the Connector tries to 

create one with the 

* given userProf ilelD . This will work unless the administrator has set permissions to 

not allow the 

* creation of new user profiles. If the Connector does not have permission, then a \t 

message 

* saying that will be returned. 

* @param props The properties object passed into handle containing the request arguments 

* @param device the device making the request. We use this when we create the profile kT 

SO that it can be 

* associated with the user. 
*/ 

private String login (Properties props. Device device) 
{ 

//Get the sessionID from the request 

String sessionID = props .getProperty (" sid" ) ; 

//Get the user profile ID from the request 

String userProf ilelD = props .getProperty (USER_PROFILE_ID_ARG) ,- 
//Get the password from the request 

String pass = props .getProperty (USER_PROFILE_PWD_ARG) ; 
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Hashtable cache = null; 

//Check to see if the User Profile exists 
if (access .userProfileExists (userProf ilelD) ) 
{ 

boolean valid = false; 

try 
{ 

//Authenticate the User Profile ID and password 
valid = access. authenticateUser (userProf ilelD, pass) ; 

//If the login was successful 

if (valid) 

{ 

//Set the session to be authenticated 

access . setSessionAuthenticated (sessionID, true) ; 

//Get the session cache 

cache = access .getSessionCache (sessionID) ; 

//Place the userProf ilelD in the cache 
cache. put (USER_PROFILE_ID_ARG, userProf ilelD) ; 

//Bring them to the main page 
return renderMenu ( sessionID) ; 

} 

//A rare case where the profile was deleted between our call to access. 

userProfileExists (userProf ilelD) 
//and access. authenticateUser (userProf ilelD, pass) ; 
catch (NoSuchUserProf ileException e ) 

return renderException ( " Your profile has been deleted or changed. Please \t 
re-register or consult your administartor . " ) ; 

//Their session has timed out 
catch (NoSuchSessionException e) 

return renderException ( "Your session has timed out. Please log in again."); 

} 

//The userProf ilelD they entered is not in the profile store, so try to create it 

else 

{ 

try 
{ 

//This creates the profile and adds the device to its list 
access . createUserProf ile (userProf ilelD , pass , appName, device) ; 

//Set the session as authenticated 

access . setSessionAuthenticated (sessionID, true) ; 

//Get the session cache 

cache = access .getSessionCache ( sessionID) ; 

//Place the userProf ilelD in the cache 
cache. put (USER_PROFILE_ID_ARG, userProf ilelD) ; 

//Bring them to the main page, 
return renderMenu (sessionID) ; 

} 

//A rare case where someone else has created a User Profile with the same name 

catch (Prof ileAlreadyExistsException e) 

{ 

return renderException ( "This Profile ID is already taken. Please choose ^ 
another. " ) ; 

} 

//If the administrator has set permission to disallow connectors from creating ^ 
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profiles 

catch (AddProfilePermissionExcept ion e) 
{ 

return renderException ( "The ThinAir Server administrator has disallowed the 
creation of new profiles!"); 

} 

//The administrator has locked the store to run UserManager 
catch (Prof ileStoreLockedException e) 

return renderException { "The ThinAir Server profile store is currently being 
configured. Try again later."); 

} 

//Their session has timed out 
catch (NoSuchSessionException e) 
( 

return renderException ( "Your session has timed out. Please re-register."); 

} 

} 

//If none of the above exceptions occurred, then they entered an invalid 

userProf ilelD 
//or a bad password or both 

return renderException ( "Your user ID or password was incorrect. Please try again.") 



/** 

* renderException creates a markup document with an error message. 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For i 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server i 

Development Guide. 

* ©param message The error message to be displayed to the user. 

* ©return A String containing the WML deck to be display to the user. 
*/ 

private String renderException (String message) 
{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard ( ) ; 

//Create a new paragraph 
Paragraph p = new Paragraph () ; 

p.addChild (new Text (message) ) ; 
p.addChild(new BreakO) ; 

//Create the URL 

String href = appPath+ " ?rnd= "+Math . random () ; 

//The go element is a task element that instructs the device to open a specified URL. 
Go go = new Go (href , true,Go .METHOD_GET) ; 

//The anchor element anchors a task to a string of formatted text. This is often : 
called a link. 

Anchor anchor = new Anchor (go, new Text ("Start again...")); 

//Add the anchor to the the paragraph 
p.addChild (anchor) ; 

//Add the paragraph to the card 
card.addParagraph(p) ; 

/ /Add the card to the deck 
deck. addCard( card) ; 
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irns the entire rendered document text, suitable for display in an WML browser 
I deck, render ( ) ,- 



README.txt 



Session Management sample Connector 
wireless SDK for ThinAir server vl.2 



About this sample 



This sample Connector demonstrates the use of sessions within the ThinAir 
Connector API. When the user first contacts the server, the Session Management 
connector creates a session object for that user and assigns it a unique 
session identifier. This session ID is then passed along back and forth to 
the device as a parameter of the HTTP request string, in this way the session 
persists each time the 'Hit again" button is pressed, while the 'Hit #' 
increases. 

N.B. This sample connector is written for wml devices only. 



Requi rements 



This sample requires the following SDK jars: 

* platform. jar 

* taglib.jar 

This sample does not require any other external APIs. 



lis sample consists of the following file tree: 
connector.ini - connector configuration file 
sessionconnector. class - compiled :ava code 
/src - java source file - sessionconnector. java 



Building the sample 



compile the sample code using the Java compiler of your choice. Make sure to 
append the required class files above into your classpath. 

Install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /Connectors subdirectory, given a name 
of your choice. 

start the ThinAir Server, it will load the sample code and begin executing it. 



Using the Sample 



wait until the Thi nAi rserver has started and the Session Management Connector 
has been loaded and initialized. From your wireless html device, or web 
browser, enter the IP address listed as the value for Appi i cationpath in 
connector.ini (your ThinAi rserver IP address), followed by /samples/session. 
For a machine with IP address 111.222.12.34 this would be: 

http : //111. 222 . 12 . 34/sampl es/sessi on 

Follow the on-screen instructions. 
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Last updated: 11.13.2000 
copyright 1999, 2000 ThinAirApps Inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Core ThinAir Server API functionality 
import com . thinairapps . platform . connector . * ; 
import com. thinairapps. platform. exception. * ; 
import com. thinairapps. platform, device. * ,- 

//Rendering packages used to build markup 
import com. thinairapps . tag .* ; 
import com . thinairapps . tag . wml . * ; 

//Core Java API 
import java.util . *; 
import java.io.*; 



/** 

* @ (#) SessionConnector . java 

* This sample Connector demonstrates the use of sessions within the ThinAir Connector API . 
A session is created when the user first contacts the Connector. The Connector generates 

■ji * a unique session ID that is then passed back and forth between the server and client with 

* each HTTP request and response. When using HTTP GET, this means adding a parameter to the 
-* URL that specifies the session ID. With HTTP POST, it involves adding a POST parameter 

for 

* the session ID in much the same way. 
-- */ 

^Apublic class SessionConnector implements Connector 
•{ 

ConnectorAccess access; 
String appPath; 



/**init() is called by the ThinAirServer when the Connector is loaded. It provides the 
Connector with 

* resources it needs to interact with the ThinAirServer. 

* ©param applicationName indicates the friendly name of the application of which this 

Connector is a part. 

* It is a String derived from connector.ini and this sample does 
not utilize it. 

* ©param applicationPath is the path to the application of which this Connector is a 

* It is a String derived from connector.ini and this sample does 
utilize it. 

* (Sparam connectorProps is a Properties object containing developer assigned, 

connector-specific properties. 

* It is derived from connector.ini and this sample does not 
utilize it. 

* ©param connectorAccess is the one-and-only interface a Connector obtains to gain 

* services offered by the ThinAir Server to running Connectors. 
This sample uses 

* it to create a session and store and retrieve data from the 
session cache. 

* ©param appLog is used for Logging 
*/ 

public void init (String applicationName, String applicationPath, Properties 

connectorProps, ConnectorAccess connectorAccess, com. thinairapps . platform. connector . 
ApplicationLog appLog) 

access = connectorAccess; 
appPath = applicationPath; 

} 
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/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getNameO method. 

* For more details about device detection and handling see the DeviceDetective sample 1/ 

connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this 1^ 

Connector supports. 

*/ 

public String [] getDevicesO 
{ 

String deviceType = "TA_WAP"; 
String [] deviceTypes = {deviceType}; 

return deviceTypes; 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming kf 
request from a 

* particular device, and returns an appropriate response. This method is called whenever^r 

the server 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request XJRLi) for a specific application. It is the responsibility of ^ 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into kT 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 1^ 

information 

* on the capabilities of the particular device making the request. 

* ©pararn reqProps - represents the HTTP request 

* Oparam device - the actual wireless device instance making the request 

* ©param out - the OutputStream to write back the response 
*/ 

public void handle (Properties props. Device device, OutputStream result) 

//A count of the number of times the user has hit the server during this session 
Integer hitNumber = null; 

//within the renderPage method, we name the sessionID parameter in the URL "sid" 
String sessionID = props .getProperty( "sid" ) ; 
//The cache for this session 
Hashtable cache = null; 

//If this is the user's first hit, they will not yet have a session 

if (sessionID == null) 

{ 

//So create one for them 

sessionID = access . createSession () ; 

} 

try 

//Get the cache for this session 

cache = access .getSessionCache ( sessionID) ; 
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} 

catch (NoSuchSessionException e) 
{ 

//Can pass any exception messages to the exception rendering method 

} 

//Get a reference to the value to which the key is mapped in the cache hashtable 
hitNumber = ( Integer) cache . get ( "hit ") ; 

//The value is null if the key is not yet mapped to any value in the cache hashtable 
//This must be the user's first time through 
if (hitNumber == null) 
{ 

//Create the first hit 
hitNumber = new Integer (1) ; 

//And store it in the cache 
cache. put ( "hit" , hitNumber) ; 

} 

//They have been here before 

else 

{ 

//So increment the existing count 

hitNumber = new Integer (hitNumber . intValue ( ) + 1) ; 

//And store it in the cache 
cache .put ( "hit" , hitNumber) ; 

} 

//Now render the result 

String resultString = renderPage (sessionID, hitNumber) ; 

//Turn the String into an array of bytes 
byte resultBytes [] = resultString.getBytes () ; 

try 
{ 

//Write the bytes to the outputStream 
result -write (resultBytes) ; 

} 

catch (lOException e) 
{ 

//Write to the 'standard' error output stream 

System. err .println ( "Error! cannot write to result OutputStream."); 

} 



/**renderPage creates the markup document to be displayed. This sample only supports WAPi^ 
devices 

* (as indicated in the getDevicesO method) and it makes use of the ThinAir WML Tag 

Library for 

* WML markup creation. 

* ©param sessionID is the unique ID for this user's session. This will be displayed to 

the user. 

* ©param hitNumber is an Integer representing how many times the user has hit the serveri^ 

during this session. 

* ©return a String containing the WML deck to be display to the user. 
*/ 

private String renderPage (String sessionID, Integer hitNumber) 
{ 

//Create a WML deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//Create a display card 

DisplayCard card = new DisplayCard ( ) ; 
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//Create a Paragraph 

Paragraph p = new Paragraph (Paragraph.ALIGN_RIGHT, Paragraph. MODE_NOWRAP) ; 

//Display the user's sessionID 
p.addChild(new Text ( "Session: "+ sessionID)); 
p . addChild (new Break ( ) ) ; 

//Display the user's hit count 

p. addChild (new TextC'Hit #:" + hitNumber.toString ( ) ) ) ; 
p. addChild (new Break ()) ; 

//Create a random parameter to be added to the URL later 

//Adding the empty string to the end of Math.randomO converts the result from a 

double to a string 
String rnd = Math.randomO + " " ; 
rnd = rnd. substring (2 , 6) ; 

//Build the URL. . . 

//Some devices cache content more than they should. Adding a random parameter is an 
unbeautif ul , 

//though often necessary technique for tricking the phone into always hitting the 
//than getting a page from its local cache. 

//n.b. Certain phones (such as the Nokia WAP Toolkit Version 2.0 simulator) require 

the absolute 
//application path so we include it here 

String href = appPath+ "?sid=" + sessionID + "&amp,-rnd=" +rnd; 

//Constructs a Go tag with the appropriate URL and link method. 
Go go = new Go (href , true , Go .METHOD_GET) ; 

//Specifies the action to perform when the user activates the link and the text the 

device will 
//Display to represent the link. 

Anchor anchor = new Anchor (go, new TextC'Hit again ...")) ; 

//Add the anchor to the Paragraph 
p . addChild (anchor) ; 

//Add the Paragraph to the card 
card.addParagraph (p) ; 

//Add the card to the deck 
deck. addCard( card) ; 

//Render it (that is, turn it into a String) 
String resultString = deck. render () ; 

//Returns the entire rendered document text, suitable for display in a WML browser 
return resultString; 

} 



README.txt 

Logging Connector Sample Connector 
wireless SDK for ThinAir Server 



About this Sample 



This connector demonstrates the logging capabilites of the ThinAir Server, it 
is a HTML only Connector 



Requi rements 

This sample requires the following SDK 3ARs: 

* platform. jar 

* taglib.jar 



sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file 
Loggingconnector. class - compiled 3ava code 
/src - java source file - OBconnector . java 



-Building the Sample 



compile the sample code using the Java compiler of your choice, wake sure to 
append the required jar files above into your classpath. 

Install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir server's /connectors subdirectory, given a name 
: of your choice. 

The logging API's uses settings in connector.ini file to place the log entries. 
Your connector.ini must have an [Output] section followed by 
[level] = [destination]. 

Exampl e : 
[Output] 

critical = STDERR, FILE: logs\criticalLog.txt 
Error = STDERR, FILE:logs\ErrorLog.txt 
Warning = stdout, file: logs\warningLog.txt 
info = STDOUT, FILE: logs\infoLog.txt 

consult the Developers guide for more information 

Start the ThinAir Server, it will load the sample code and begin executing it. 



using the Sample 



Wait until the Thi nAi rServer has started and the OBconnector has 
been loaded and initialized. From your wireless wml device, or web browser, 
enter the IP address listed as the value for ApplicationPath in connector.ini 
(your ThinAi rServer ip address), followed by /sampl es/Loggi ngconnector . For 
a machine with IP address 111.222.12.34 this would be: 
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http : //111 .211. Yl. 34/sampl es/Loggi ngconnector 
Follow the on-screen instructions. 



Last updated: 11.13.2000 
copyright 1999, 2000 ThinAirApps Inc. 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//Standard ThinAir server imports 
import com. thinairapps .platform. connector . * ; 
import com . thinairapps . plat form . device . * ; 
import com. thinairapps . tag .html . * ; 

//Standard Java Imports 
import java.util.*; 
import java.io.*; 

/** 

* This Connector is for demonstrating the Logging capabilities of the ThinAir Server. The 

user can select 

* which log file to write to. The location of the log file is determined by the connector. 

ini 

* settings. Please refer to the JavaDocs for a comprehensive list of the methods available. 
*/ 

public class LoggingConnector implements Connector 
{ 

ApplicationLog appLog; 
string appPath; 



/**init() is called by the ThinAirServer when the Connector is loaded. It provides the 
Connector with 

* resources it needs to interact with the ThinAirServer. 

* For more information about the Connector interface, see the javadocs for the ThinAir 

Server API 

* (Sparam appName is a String derived from connector.ini. We used this to format our 

action field in the form tag 

* ©param ap is a String derived from connector.ini. We don't need this for this sample. 

* Oparam props is a Properties list containing developer assigned connector- specif ic 

properties . 

* We don't need this parameter in this sample. 

* @param connectorAccess is our access point to the services provided by ThinAir Server 

We don't need this for this sample. 

* ©param al is the Application Log instance that we use to write to the appropiate logs 

We used this to write to logs 

*/ 

public void init (String appName, String ap. Properties props, ConnectorAccess ca, 
ApplicationLog al) 

{ 

//Set the two values 
appLog = al ; 
appPath = ap; 

} 



/**getDevices ( ) is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf lie . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getName ( ) method. 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 
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* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this ^ 

Connector supports. 

*/ 

public String I] getDevicesO 
{ 

String devices [] = { "TA_HTML" }; 
return devices; 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming ^ 
request from a 

* particular device, and returns an appropriate response. This method is called whenever i^' 

the server 

* receives a request from a type of device that the Connector indicates it supports, nf 

destined {as 

* indicated in the request URL) for a specific application. It is the responsibility of 

the Connector 

* to interpret the request and generate an appropriate response.^ 

* The server will pass a Device object containing as much information as possible into <^ 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 

* @param reqprops a set of name value pairs corresponding to the HTTP request parameters 

from the device. 

* Oparam dev a Device object created in the image of the actual device making this 

request . 

* ©param out a reference to the OutputStreara that will be returned to the device. 
*/ 

public void handle (Properties reqProps, Device dev, OutputStream out) 
{ 

String result; 
int actionCode; 
String sactcode; 

//Get the actionCode from the form, if this the first time through, then getProperty ^ 

will return null 
sactcode = reqProps .getProperty ( "actionCode" ) ; 

//Since this is the first time through we do not need to check, so we set actionCode 

to zero 
if (sactcode == null) 

actionCode = 0; 

else 

//otherwise we parse actionCode into a int 

actionCode = Integer .parseint (sactcode) ,- 
Form mainForm; 
String msgString = " " ; 

//Start Generating HTML 

HTMLTagDocument htmlDoc = new HTMLTagDocument () ; 
Head htralHead = new Head ( ) ; 
htmlDoc.addChild(htmlHead) ; 
Body htmlBody = new Body ( ) ; 

//check whether actionCode has been set 

if (actionCode != 0) 

{ 

//test actionCode 
switch (actionCode) 
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//Using the instance of ApplicationLog that was passed in the init method 
//and depending on what the actionCode is, we call the appropiate logger \i 
method . 

//The logging methods uses the following conventions: 

//logXXX (< string of method call>, <error code>, <message>, <boolean of 

whether or not to display the connector name>) 
//where XXX is the log Level name (Emergency, Critical, Alert, Error, Warning liT 

, Notice, Info, Debug) 
//for more detail information, please refer to the Developers Guide 
case 1: 

appLog. logEmergency( "handle 0" , 1100, "Emergency message- Indicate fatal \^ 
conidition, probably resulting in exception every time code is excuted" , 
true) ; 

msgString = "An Emergency message was written to the location specified in 

connector. ini" ; 
break ,- 
case 2: 

appLog. logCritical ( "handle ()" , 2100, "Critical message-Critical conditions, i^- 

such as hard device errors", false); 
msgString = "A Critical message was written to the location specified in \i 

break ; 

appLog . logAlert ( "handle ()" , 3100, "Alert message-A condition to be corrected 

immediately, such as a corrupt system", true) ; 
msgString = "An Alert message was written to the location specified in 

connector . ini " ; 
break ; 
"= case 4: 

appLog .logError { "handle ()" , 4100, new Exception ( "Throwing Exception for 

Logging Error"), true) ,- 
msgString = "An Exception was thrown to the location specified in connector, kf 

break ; 
case 5: 

appLog . logWarning ( "handle ()" , 5100, "Warning message-Indicate an unusual 

condition that the app will handle automatically but which is noted in ^ 
the log to help diagnose futre errors", false); 

msgString = "A Warning message was written to the location specified in 
connector . ini " ; 

case 6 : 

appLog. logNotice( "handle 0 ", 6100, "Notice message-Conditions that are not ^ 

errors, but may require special handling", false); 
msgString = "A Notice message was written to the location specified in \^ 

connector . ini " ; 
break; 
case 7 : 

appLog . loglnfo ( "handle 0 " , 7100, "Info message-Normal Status message", true); 
msgString = "An Info message was written to the location specified in 
connector . ini " ; 

appLog.logDebug( "handle 0 ", 8100, "Debug message-for logging debug msgs ^ 

during development process", false); 
msgString = "A Debug message was written to the location specified in \^ 

connector.ini" ; 

default : 

break; 

} 

//Add the msg to HTML 

htmlBody.addChild(new Text (msgString) ) ; 
htmlBody.addChild(new Break () ) ; 

} 

//Construct the mainSelection Form 
mainForra = renderMainSelection { ) ; 
htmlBody .addChild(mainForm) ; 



C: \TASS\WirelessSDK\Samples\General\Logging\src\LoggingConnector ■ java 



htmlDoc.addChild(htitilBody) ; 
//Render the HTML 
result = htmlDoc . render () ; 
try 
{ 

//Write out 

out .write (result .getBytes ( ) ) ; 

} 

catch (Exception e) 
{ 

//Catch the exception 

appLog . logError ( "handle 0" , 4100, "Error writing to Outputstream: " + e. 
getMessageO, true) ; 

} 



//This function creates the Form using the HTML tag libraries 

public Form renderMainSelection { ) 

{ 

Form formtag = new Form ( "Logging" , appPath, "GET" ); 

formtag.addChild(new Text ("Please select which Log you would like to write to:")); 
formtag.addChild(new Break () ) ; 
formtag.addChild(new Text ( "Emergency" ) ) ; 

Input emergency Input = new Input ( "radio" , " actionCode " , "1"); 
formtag . addChi Id ( emergencylnput ) ; 
formtag.addChildCnew BreakO); 

formtag.addChildCnew Text ( "Critical" ) ) ; 

Input alertlnput = new Input ( "radio" , "actionCode", "2"); 
formtag . addChild(alertlnput) ; 
formtag.addChildCnew BreakO); 

formtag.addChildCnew Text ( "Alert" ) ) ; 

Input criticallnput = new Input ( "radio" , "actionCode", "3"); 
formtag . addChi Id {criticallnput ) ; 
formtag.addChildCnew BreakO); 

formtag.addChildCnew Text C "Error " ) ) ; 

Input errorlnput = new Input ( "radio" , "actionCode", "4"); 
formtag. addChildCerrorlnput) ; 
formtag.addChildCnew BreakO ) ; 

formtag.addChildCnew Text C "Warning" ) ) ; 

Input warnlnput = new Input C "radio" ^ "actionCode", "5"); 
formtag. addChildCwarnlnput) ; 
formtag.addChildCnew Break () ) ; 

formtag.addChildCnew Text C "Notice" ) ) ; 

Input noticelnput = new Input ( "radio" , "actionCode", "6"); 
formtag.addChildCnoticelnput) ; 
formtag.addChildCnew BreakO ) ; 

formtag.addChildCnew Text (" Info ") ) ; 

Input infolnput = new Input ( "radio" , "actionCode", "7"); 
formtag. addChildCinfoInput) ; 
formtag.addChildCnew BreakO) ; 

formtag.addChildCnew Text C "Debug ") ) ; 

Input debuglnput = new Input C " radio " , "actionCode", "8"); 
formtag. addChild(debuglnput) ; 
formtag.addChildCnew BreakO) ; 

formtag.addChildCnew SubmitButton C "Submit" ) ) ; 



return formtag; 
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README . txt 



HTML Rendering Sample Connector 
wireless SDK for ThinAir server 



About this Sample 



This sample Connector demonstrates the use of the HTML Tag library to accept 
input from HTML forms and render output for HTML browsers. 



Requi rements 

This sample requires the following SDK JARs: 

* platform. jar 

* taglib.jar 

This sample does not require any other external APIs. 



.sample Files 

This sample consists of the following file tree: 
connector.ini - connector configuration file 
HTMLRendererconnector. class - compiled Java code 
/src - java source file - HTMLRendererconnector .java 



Building the Sample 



Compile the sample code using the Java compiler of your choice. Make sure to 
append the required jar files above into your classpath. 

Install the compiled sample code and connector.ini configuration file into a 
subdirectory of the ThinAir Server's /connectors subdirectory, given a name 
of your choice. 

Start the ThinAir Server, it will load the sample code and begin executing it. 



Using the Sample 



wait until the Thi nAi rserver has started and the html Rendering connector has 
been loaded and initialized. From your wireless HTML device, or web browser, 
enter the IP address listed as the value for Applicationpath in connector.ini 
(your ThinAi rserver IP address), followed by /samples/html. For a machine with 
IP address 111.222.12.34 this would be: 

http://lll. 222 . 12 . 34/sampl es/html 

Follow the on-screen instructions. 



Last updated: 11.13.2000 
copyright 1999, 2000 ThinAirApps inc. 

Page 1 
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* @(#) HTMLRendererConnector 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE i^- 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 
*/ 



//ThinAir Platform import 

import com . thinairapps . platform. connector . * ; 
import com. thinairapps . platform. device . * ; 

//ThinAir Tag Libraries import 
import com. thinairapps. tag.*; 
import com. thinairapps . tag .html . * ; 

/ / Standara Java import 
import java.util.*; 
'import j ava . io . * ; 



/** 

* This is a simple sample whose purpose is to illustrate the use of the ThinAir HTML 

* Tag Library. It creates two simple HTML decks: the first prompts the user for their 

* favorite color, username and password, the second simply echos the submitted values. 

*■ This sample makes use of HTMLTagDocument , Body, Form, Labeledlnput , PasswordField, Select, 

* Option, SubmitButton, Table, TableRow and TableCell. 

* For a comprehensive reference of the HTML Tag Library, see the ThinAir Javadoc API 

documentation . 

*/ 

public class HTMLRendererConnector implements Connector 
String path; 

//The friendly name of this sample app 
String appName; 

//Our access point to the services of ThinAir Server 
ConnectorAccess access; 



/** 

* initO is called by the ThinAirServer when the Connector is loaded. It provides the 

* Connector with resources it needs to interact with the ThinAirServer. 

* For more information about the Connector interface, see the ThinAir Javadoc API ^ 

documentation . 

* ©param applicationName is a String derived from connector.ini. We don't need this fori^' 

this sample. 

* @param applicationPath is a String dervid from connector.ini. We don't need this for W 

this sample. 

* @param connectorProps is a Properties list containing developer assigned ^ 

connector- specif ic properties. 

* We don't need this parameter in this sample. 

* @param connectorAccess is our access point to the services provided by ThinAir Server k' 

We don't need this for this sample. 

* ©pararn ApplicationLog is used for Logging. We do not use this parameter in this 
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public void init (String applicationName , String applicationPath, Properties 
connectorProps, ConnectorAccess connectorAccess , ApplicationLog al) 

appName = applicationName ; 
access = connectorAccess; 
path = applicationPath; 



/** 

* getDevicesO is called once by the ThinAir Server during start-up. It allows a 

Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing ^ 

the names of all 

* DeviceProf iles supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer i^' 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getNaraeO method. 

* For more details about device detection and handling see the DeviceDetective sample 

connector and the 

* ThinAir Server Developer Guide . 

* ©return an array of Strings representing the friendly names of the devices this ^ 

Connector supports. 

*/ 

public String [] getDevicesO 
{ 

String deviceType = "TA_HTML"; 

String deviceTypes [] = { deviceType }; 

return deviceTypes; 



/** 

* The handle method implements the core logic of a Connector. It takes an incoming ^ 

request from a 

* particular device, and returns an appropriate response. This method is called whenever 

the server 

* receives a request from a type of device that the Connector indicates it supports, yC 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of ^ 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 

* (gparam props a set of name value pairs corresponding to the HTTP request parameters 

from the device. 

* (Sparam device a Device object created in the image of the actual device making this \l 

request . 

* @param result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle (Properties props, Device device, OutputStream result) throws 
lOException 

{ 

String resultString = null; 

//get the 'action' parameter from the request. 

//This is an HTTP param we define to determine what action to take when we get a ^ 
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String action = props. getPropertyC'a" ) ; 

//if this is the first hit (or any request for the main deck) 

if (action == null) 

{ 

// build a deck that lets the user enter information. 
resultString = renderWelcotne ( ) ; 

} 

//if they have already entered the information, then display it... 
else if (action. equals ( "display" ) ) 

//build a display deck with the entered info, pass the request properties in... 
resultString = renderAnswers (props) ; 



result .write (resultString. getBytes () ) ,- 



* This method renders a page with a form for entering information. . . 

* ©return the rendered page. 
*/ 

private String renderWelcome ( ) 
{ 

//create the page 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

//create the body 

Body body = new Body ( ) ; 

//set the background color 

body. addAttribute( "bgcolor", "#ffffff ") ; 

Bold bold = new Bold ( ) ; 

//add a title 

bold. addChild (new Text("Render HTML Connector: Welcome") ); 
body. addChild (bold) ; 
//create a input Form 

Form form = new Form ("render", path + "?a=display" , "POST") ; 

form. addChild (new HorizontalRule ( ) ) ,- 

//Create a dropdown list... 

Select colorSelect = new Select ("color"); 

//create some choices 
Option red = new Option ( "r" , "Red" ) ; 
Option orange = new Option ( "o" , "Orange" ) ; 
Option yellow = new Option ( "y" , "Yellow" ) ; 
Option green = new Option ( "g" , "Green" ) ; 
Option blue = new Option ( "b" , "Blue" ) ; 
Option indigo = new Option (" i "," Indigo" ) ; 
Option plaid = new Option ( "p" , "Plaid" ) ; 

//add the choices 
colorSelect .addOption (red) ; 
colorSelect .addOption (orange) ; 
colorSelect. addOption (yellow) ; 
colorSelect .addOption (green) ; 
colorSelect. addOption (blue) ; 
colorSelect .addOption (indigo) ; 
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colorSelect . addOption (plaid) ; 
Bold colorLbl = new BoldO ; 

colorLbl .addChild(new Text ( "Favorite color: ")); 

//add a label 

form. addChild( colorLbl) ; 

//add the select to the Form 
form.addFormElement (colorSelect) ; 
form. addChild (new Break ( ) ) ; 

//add an input field 

form.addFormElement (new Labeledlnput ( "usr" , "Username: ")); 
form. addChild (new Break ( ) ) ,- 
//create a password field 

PasswordField pwdlnput = new PasswordField ( "pwd" ) ; 
//add a label 

form. addChild (new Text ("Password: " ) ) ; 

//add the password field 
form.addFormElement (pwdlnput) ; 
form. addChild (new Break { ) ) ; 

form. addChild (new HorizontalRule ( ) ) ; 
form. addChild (new Break { ) ) ; 

//add a button. . . 

form. addFormElement (new SubmitButton ("Next")); 
body. addChild (form) ; 
doc .addChild (body) ; 

String resultString = doc. render () ; 
return resultString,- 



/** 

* Create a page with the results of the query above 

* (gparam props Properties of user responses 

* ©return String of HTML page for display 
*/ 

private String renderAnswers (Properties props) 
{ 

//get the arguments passed from the welcome deck 
string usrName = props . getProperty ( "usr" ) ; 
String password = props . getProperty ( "pwd" ) ; 

//this will be a single letter, so we have to map it to a color 
String color = props .getProperty ( "color" ) ; 
if (color == null) 

return renderException ( "Error ! No color was entered."); 
if (color . equals ( "r" ) ) 

color = "Red" ; 
else if (color . equals ( "o" ) ) 

color = "Orange"; 
else if (color . equals ( "y" ) ) 

color = "Yellow"; 
else if (color. equals ("g") ) 

color = "Green" ; 
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else if (color . equals ( "b" ) ) 

color = "Blue" ; 
else if (color . equals ( "i" ) ) 

color = "Indigo" ; 
else if (color . equals ( "p" ) ) 

color = "Plaid" ; 



//create the page 

HTMLTagDocument page = new HTMLTagDocument ( ) ; 

Body body = new Body ( ) ; 

//set the background color 
body.addAttribute( "bgcolor", "#ffffff ") ; 

//create a new Table with a thin border 
Table table = new Table(l); 

//create a TableRow 

TableRow tr = new TableRowO; 

//create a TableCell 

TableCell tc = new TableCell () ; 

//add the text 

tc . addChild (new Text ( "Color : " ) ) ; 

//add the cell to the row 
tr. addChild (tc) ; 

//make a new cell 

tc = new TableCell 0 ; 



//add the text 

tc. addChild (new Text (color) ) ; 

//add the cell to the row 
tr.addChild(tc) ; 

//add the row to the table 
table. addChild (tr) ; 

//continue this for each row... 

tr = new TableRowO; 

tc = new TableCell 0 ; 

tc. addChild (new Text ( "Username : " ) ) ; 

tr .addChild(tc) ; 



tc = new TableCell () ; 

tc. addChild (new Text (usrName) ) ,- 

tr.addChild(tc) ; 

table. addChild (tr) ; 

tr = new TableRowO; 
tc = new TableCell ( ) ; 

//Show the password for this sample. Of course, this is not recommended... 
tc. addChild (new Text ( "Password: ")); 
tr. addChild (tc) ; 



tc = new TableCell 0 ; 

tc. addChild (new Text (password) ) ; 

tr. addChild (tc) ; 

table. addChild (tr) ; 

//add the table to the page's body 
body.addChild(table) ; 



//add the body to the page 



C: \TASS\ . ■ \General\HTMLRendering\src\HTMLRendererConneGtor. java 



6 



page .addChild (body) ; 
//render the page 

String resultString = page . render () ; 
return resultString; 



* This is a simple exception rendering method. 

* ©param message the message to be presented to the user 

* ©return the rendered HTML page deck 
*/ 

private String renderException (String message) 
//create the page 

HTMLTagDocument page = new HTMLTagDocument ( ) ; 

Body body = new Body ( ) ; 

/ / set the background color 

body .addAttribute ("bgcolor" , "#f ff ff f " ) ; 

body. addChild (new Text (message) ) ; 
body. addChild (new BreakO); 

String resultString = body . render () ; 

return resultString; 



' ^ C: \TASS\WirelessSDK\ . . \General\Portal\MainPortal\PortalConnector . j ava 1 

import com. thinairapps . platform. connector . * ; 
import com. thinairapps . tag .html . * ; 
import com. thinairapps . platform. device . * ; 

import java.util.*; 
import j ava . io. * ; 

/** 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved. 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE li" 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 

* The basis of this sample application is to demonstrate the "portal" example where there kT 

is a 

* single log on and then the user can proceed to other "applications" within the portal. In^r 

this 

* case the user logs in and then is presented with a menu of 2 other applications. When thei^* 

user 

* enters one of the applications it then checks to see if it has been configured yet, if it 

O* it will then present the configuration fields, the user enters and proceeds, the 
application then displays 
the information entered. At this time the user can either go back to the original 
application, where it will display 
-* the data entered previously or proceed to the second app and the same process repeats. wr 
This demonstrates how a developer 

* can develop numerous apps with a single log in. The main detail being the ability to passi^ 

the Session ID around and 
''H* use it for each application to store data (in this case the user ID and password) 
ill* This connector is the main connector that leads to the other "apps". It uses Sessions 
'"' and User Profiles. Sessions 

* are temporary while User Profile is stored and can be retrieved at a later time. 
*/ 

■■public class PortalConnector implements Connector 

ConnectorAccess myCA; 
; String appPath; 

//need to store the ConnectorAccess and ApplicationPath 

public void init (String name. String p. Properties iniProps, ConnectorAccess ca, \^ 
ApplicationLog al) 

{ 

myCA = ca; 
appPath = p; 

} 

//this connector only supports HTML 

public String [] getDevicesO 

{ 

String [] devices = { " TA_HTML " } ; 
return devices; 

} 

public void handle (Properties regProps, Device device, OutputStream out) throws 
lOException 

{ 

String sid = null; 
String result = null; 
String firstTime; 
Hashtable cache = null; 



String login; 
String passwd; 
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//these variables are used to keep track of when a user enters and what screen shouldi/" 

be presented 
firstTime = reqProps .getProperty ( "f irstTime" ) ; 
sid = reqProps -getProperty { "sid" ) ; 
if (firstTime == null) 
{ 

//If it is the firstTime then 
result = generateLcgin ( ) ; 

} 

else 
{ 

//It's not the first time, but I still haven't generated a Session ID yet 

if {sid == null) 

{ 

try 
{ 

//Create the session using ConnectorAccess 

sid = myCA. createSession ( ) ; 

//get the cache for this session 

cache = myCA. getSessionCache ( sid) ; 

} 

catch (Exception e) 
{ 

//Can pass any exception messages to the exception rendering method 
} 

//As long as I get the cache, then proceed to populate with data 

if (cache 1= null) 

{ 

login = reqProps .getProperty ( "usr" ) ; 
passwd = reqProps . getProperty ( "pwd" > ; 
cache . put ( "usr" , login) ; 
cache .put ( "pwd" , passwd); 
} 

} 

//The values are stored in the cache, display the menu to the user 
result = generateMenu { sid) ; 



out .write (result .get Bytes ( ) ) ; 



public String generateLcgin ( ) 
{ 

//Generate the HTML for the User to Login 
HTMLTagDocument html Tag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph () ; 

pTag.addChild(new Text ( "Welcome to the Portal")); 
pTag.addChild(new Break ()) ; 
pTag.addChild(new Text ("Please Login")); 
pTag .addChild(new Break ()) ; 
bodyTag . addChild (pTag ) ; 

Form formXag = new Form ("Login", appPath, "POST"); 

f ormTag .addFormElement (new Labeledlnput ( "usr " , "Username: ")); 

formTag .addChild (new Break () ) ; 

PasswordField pwdlnput = new PasswordField ( "pwd" ) ; //create a password field 
formTag. addChild (new Text ( "Password: ")); //add a label 
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formTag.addFormElement (pwdlnput) ,- //ad the password field 

f ormTag -addChild (new Break ()) ; 

formTag.addChild(new Hiddenlnput ( " f irstTime" , "Yes") ) ; 
f ormTag .addChild (new SubmitButton ("Submit")); 

bodyTag. addChild (f ormTag) ; 

htmlTag. addChild (bodyTag) ; 

return html Tag . render () ; 



public String generateMenu (String sid) 
{ 

//generate the Menu 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ,- 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag. addChild (new Text ("Please select the application you woud lilte")); 
pTag. addChild (new Break () ) ; 

bodyTag. addChild(pTag) ; 

Anchor anl = new Anchor ("Applicationl" , "/portal/appl?sid= " + sid, new Text <^ 
("Application 1") ) ; 

Anchor an2 = new Anchor ( "Application2 " , "/portal/app2?sid=" + sid, new Text ^ 

("Application 2") ) ; 
bodyTag. addChild (anl) ; 
bodyTag. addChild (new Break () ) ; 
bodyTag. addChi Id (an2) ; 
bodyTag. addChild (new Break {)) ; 



html Tag. addChild (bodyTag) ; 
return htmlTag . render ( ) ; 
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/** 

* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved. 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE >l 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 

* Here is just a class that has some properties and methods, the main thing to mention is ^ 

that 

* it implements Serializable, this is required to store data in UserProfile 
*/ 

public class ApplicationlUserData implements j ava . io . Serializable 
{ 

private String ssNum; 

private String pas sword ,- 

private String host; 

private String additionalParam; 

public ApplicationlUserData ( ) 

s sNum= " Unknown " ; 
password="None " ; 
host="n/a" ,- 

additionalParam="n/a" ; 



public ApplicationlUserData (String ssn, String pw, String ht. String ap) 

ssNum = ssn; 
password = pw; 
host = ht; 

additionalParam = ap; 



public void setssNum(String ssn) 
ssNura = ssn; 



public void setPassword { String pw) 
password = pw; 



public void setHost (String ht) 
host = ht; 



public void setAdditionalParam( String ap) 
additionalParam = ap; 



public String getssNum() 
return ssNum; 



public String getPassword ( ) 
return password; 



public String getHost () 
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public String getAddditionalParam { ) 
{ 

I additionalParam; 
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import com . thinairapps . platform. connector . * ; 
import com . thinairapps . tag . html . * ; 
import com. thinairapps . platform. device . * ; 

import java.util.*; 
import java.io.*; 



* Copyright (c) 2000 ThinAirApps, Inc. All Rights Reserved. 

* ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE LICENSE 

AGREEMENT 

* BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR USE OF THE SOFTWARE IN VIOLATION OF 

THE 

* SOFTWARE LICENSE AGREEMENT IS STRICTLY PROHIBITED. 

* This Connector is called from the main menu of the portal. It first checks to see if the ^ 

session passed in is valid 

* Then it checks to see if the user is in User Profile, if their is an entry then display 

the data, if there isn't 

* then display the configuration field and have the user enter the dgita. There is a bit of ^ 

a tricky part and the way 

* I've implemented is not the most robust way. The tricky part deals with if a user alreadyi^ 

has a User Profile, but from 

* another application. In that case it needs to check if the data in User profile is kf 

associated with this application 

* in particular. I've marked the code where the logic is taking place 
*/ 

jjiublic class ApplicationlConnector implements Connector 

ConnectorAccess applCA; 
String applPath; 
String applName,- 

public void init (String appName, String appPath, Properties connectorProps , 
ConnectorAccess ca, ApplicationLog al) 

{ 

applCA = ca; 
applPath = appPath; 
applName = appName,- 

} 

public String [] getDevicesO 
{ 

return new String [] { " TA_HTML " } ; 



public void handle (Properties appProps, Device dev, OutputStream out) 

String sid; 
String usrName; 
String password; 
String result; 
String dataEntered; 

boolean valid; 
boolean userExists; 
Hashtable cache = null; 

//first get the SID, in this case the only way that a user should enter this ^ 
application is through the menu 

sid = appProps .getProperty (" sid" ) ; 

//another variable to see where the user is 

dataEntered = appProps .getProperty ( "dataEntered" ) ; 
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//check to see if the session is valid, it might have timed out.... 
valid = applCA. sessionValid ( sid) ; 

if (valid) 
{ 

//extract user information 
//Now get the cache from the SID 
try 
{ 

cache = applCA.getSessionCache (sid) ,- 
} 

catch (Exception e) 
{ 

//catch NoSuchSessionException 



//retrieve the username and password 
usrName = (String) cache .get ( "usr" ) ; 
password = (String) cache .get ( "pwd" ) ; 

//Here's the TRICKY part, now we go and look to see if there is data associated 
with this 

//application in particular. The method userProf ileExistg does not tell us whichi^ 

application 
//(if any) there is data for. 

userExists = applCA . userProf ileExists (usrName ) ; 

ApplicationlUserData applUserEnteredData = null; 

try 

{ 

//Here is where we try to see if there is data associated with this ^ 
application 

applUserEnteredData = (ApplicationlUserData) applCA. getUserProfileData (usrName 
, applNarae) ; 

} 

catch (Exception e) 
{ 

//catch NoSuchUserProf ileException 

} 

/ /Here we check 2 things 

//I) If the user does not exist, then it is his first time and display the 

configuration screen 
//2) Or he already exists, but the data is for another application, display the 

configuration screen for htis application 
if { luserExists || applUserEnteredData == null) 
{ 

//check to see if data for user has been entered 

//this needs to be passed twice, once to check if user exists, then check 

again for entering data 
if (dataEntered != null) 
{ 

//store user data 

/ / instatiate ApplicaitonlUserData 

ApplicationlUserData applUserData = new ApplicationlUserData () ,- 
//Set the variables 

applUserData. setssNum (appProps .getProperty ( "ssNum" ) ) ; 
applUserData. setPassword (appProps .getProperty ( "pwd" ) ) ; 
applUserData . setHost (appProps .getProperty ( "host " ) ) ; 

applUserData . setAdditionalParam( appProps .getProperty ( "additionalParam" ) ) ,- 

//Ist create the user profile 

try 

{ 

//Here's another check, if the user already exists, and we are here that i^r 
means 

//there was no data for this application, but we do not need to create 

another userprofile 
//so if the User does not exist, then create.... 
if (luserExists) 



C:\TASS\ ■ ■ \General\ Portal \MainPortal \Applicat ionlConnector ■ java 



3 



applCA.createUserProf ile (usrName, password, applName) ; 

} 

//2nd now add the application data 

applCA. setUserProfileData (usrName, applName, applUserData) ; 

} 

catch (Exception e) 
{ 

//catch exception for Prof ileAlready Exists 
//catch exception for Prof ileStoreLockedException 

} 

//Some HTML to tell the user that the data has been stored 
HTMLTagDocument html Tag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph (), • 

pTag.addChild{new Text ( "Application 1 User Added")); 
pTag.addChild(new BreakO); 

pTag.addChild(new Text ("For User " + usrName)),- 
pTag . addChild (new Break ( ) ) ; 
bodyTag . addChild (pTag) ,- 

//View the data entered, incorporate the SID ii 
Anchor anl = new Anchor ("View Data", applPath ^ 

Data") ) ; 
bodyTag. addChild (anl) ,- 
html Tag . a ddCh i 1 d ( bodyTag ) ; 

out. write ( html Tag . render ( ) .getBytesO) ; 
catch (Exception e) 

//catch out exception 



//Else the user does not exist so display the configuration screen 

result = renderlnputUserDataScreen(sid) ; 

try 

{ 

out. write (result. getBytesO ) ; 
} 

catch (Exception e) 
{ 

//catch 10 excecption 



//if user exists and Application Data for this app exist 

already is there 
//so display data to user 
{ 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag. addChild (new Text ( "Application 1 Data")); 
pTag. addChild (new BreakO); 

pTag. addChild (new Text("For User " + usrName)); 
pTag. addChild (new BreakO ) ; 
bodyTag. addChild (pTag) ; 
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bodyTag.addChildCnew Text ("Social Number: " + applUserEnteredData . 

getssNumO ) ) ; 
bodyTag.addChild(new BreakO); 

bodyTag.addChildCnew Text ( "Password: " + applUserEnteredData . getPassword 
( ) ) ) ; 

bodyTag.addChildCnew BreakO ); 

bodyTag.addChildCnew Text("Host: " + applUserEnteredData . getHost ())) ; 
bodyTag.addChildCnew BreakO); 

bodyTag.addChildCnew Text C "Additional Parameter: " + applUserEnteredData . li- 

getAddditionalParam ( ) ) ) ; 
bodyTag.addChildCnew BreakO); 

bodyTag.addChildCnew Text C "This data is now stored in UserProfile and cank^ 
be retrieved at any time with the Login and Password<br>" ) ) ; 

Anchor anl = new Anchor ( "Menu" , "/portal?f irstTime=l&sid=" + sid, new \i 
Text ("Return to Portal Menu")); 

bodyTag.addChildCanl) ; 

htmlTag.addChildCbodyTag) ; 

try 

{ 

out . write ( htmlTag . render ( ) . getBytes ( ) ) ; 

catch (Exception e) 
{ 

//catch out exception 

} 



else 
{ 

String result2 = "Sorry Session is not valid or Timed Out, please login again" 

try 

{ 

out .write (result2 .getBytes ( ) ) ; 
} 

catch (Exception e) 

\ 



public String renderlnputUserDataScreen (String sid) 
{ 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag.addChildCnew Text("Please configure Application 1")); 
pTag.addChildCnew BreakO); 
pTag.addChildCnew Text("Enter Data")); 
pTag . addChi 1 d ( new B reak ( ) ) ; 
bodyTag . addChi 1 d ( pTag ) ; 

Form formXag = new Form ("UserData", applPath, "POST"); 

fortiiTag.addFormElement (new Labeledlnput ( "ssNum" , "Social Security Number: ")); 
formTag.addChild (new BreakO ) ; 

PasswordField pwdlnput = new PasswordField ( "pwd" ) ; 

formTag.addChild (new Text ( "Password: ")); 
f ormTag .addFormElement (pwdlnput) ; 
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formTag.addChild(new Break () ) ; 

formTag.addFormElement (new Labeledlnput ( "host" , "Host: " ) ) ; 
formTag.addChHd(new Break () ) ; 

formTag.addFormElement (new Labeledlnput ( "additionalParam" , "Additional Parameter 
: " ) ) ; 

forTnTag.addChild(new Break ( ) ) ; 
f ormTag . addChild (new Hiddenlnput ( " sid" , sid) ) ; 
formTag.addChild(new Hiddenlnput ( "dataEntered" , "Yes") ) ; 
f ormTag. addChild (new SubmitButton ("Submit")),- 

bodyTag. addChild (f ormTag) ,- 

htmlTag. addChild (bodyTag) ; 



return html Tag . render ( ) 
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catch (Exception e) 
{ 

//catch NoSuchUserProf ileException 

} 

if (iuserExists | | app2UserEnteredData == null) 
{ 

//check to see if data for user has been entered 

//this needs to be passed twice, once to check if user exists, then checker 

again for entering data 
if (dataEntered != null) 
{ 

//store user data 

//instatiate ApplicaitonlUserData 

Application2UserData app2UserData = new Application2UserData ( ) ; 
//Set the variables 

app2UserData. setPref erences (appProps .get Property ( "preferences" ) ) ; 
app2UserData. setAge (Integer .parseint (appProps .getProperty( "age" ) ) ) ; 



//1st create the user profile 

try 

{ 

if ( luserExists) 
{ 

app2CA. createUserProf ile (usrName , password, app2Name) ; 
//2nd now add the application data 

app2CA. setUserProfileData (usrName , app2Name, app2UserData) ; 

catch (Exception e) 
{ 

//catch exception for Prof ileAl ready Exists 
//catch exception for Prof ileStoreLockedException 

} 



HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ,- 

pTag.addChild(new Text { "Application 2 User Added")); 
pTag.addChildCnew Break ( ) ) ; 

pTag.addChild(new Text ("For User " + usrName)); 
pTag.addChild(new Break ( ) ) ; 
bodyTag. addChild(pTag) ; 

Anchor anl = new Anchor("View Data", app2Path + "?sid=" + sid, new irf 

Text ( "View Data " ) ) ; 
bodyTag . addChild (anl ) ; 
htmlTag .addChild (bodyTag) ; 
try 
{ 

out. write ( htmlTag . render ( ) .getBytesO) ; 

} 

catch (Exception e) 
{ 

//catch out exception 

} 

} 

else 
{ 

result = renderlnputUserDataScreen ( sid) ; 

try 

{ 

out .write (result .getBytes () ) ; 
} 

catch (Exception e) 
{ 
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//catch lO excecption 

} 

} 

} 

else 

//if user exists that means that data already is there 

//so display data to user 

{ 

HTMLTagDocument htmlTag = new HTMLTagDocument { ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag.addChild(new Text ( "Application 2 Data")); 
pTag . addChild (new Break ( ) ) ; 

pTag.addChild(new Text("For User " + usrName) ) ; 
pTag . addChild (new Break ( ) ) ; 
bodyTag. addChild (pTag) ; 

bodyTag. addChild (new Text ( "Preferences : " + app2UserEnteredData . 

getPref erences ( ) ) ) ; 
bodyTag. addChild (new Break () ) ; 

bodyTag. addChild (new Text("Age: " + app2UserEnteredData .getAge () ) ) ; 
bodyTag. addChild (new Break () ) ; 

bodyTag. addChild(new Text ("This data is now stored in UserProfile and cani^" 
be retrieved at any time with the Login and Password<br> " ) ) ; 

Anchor anl = new Anchor ( "Menu" , "/portal?f irstTime=l&sid= " + sid, new >^ 
Text ("Return to Portal Menu")),- 

bodyTag. addChild (anl) ; 

htmlTag. addChild (bodyTag) ; 

try 
{ 

out . write ( htmlTag . render ( ) . getBytes ( ) ) ; 
} 

catch (Exception e) 
{ 

//catch out exception 

} 

} 

} 



String result2 = "Sorry Session is not valid or Timed Out, please login again"; 

try 

{ 

out .write (result2 .getBytes ( ) ) ; 
} 

catch (Exception e) 

{ 

} 



public String renderlnputUserDataScreen (String sid) 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body ( ) ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag . addChild (new Text("Please configure Application 1")); 

pTag. addChild (new Break ()) ; 

pTag. addChild (new Text ("Enter Data")); 

pTag . addChild (new Break ( ) ) ; 

bodyTag. addChild (pTag) ; 
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Form formTag = new Form ("UserData", app2Path, "POST"); 

f ormTag . addFormElement (new Labeledlnput ( "preferences" , "Preferences 

formTag . addChild (new Break ( ) ) ; 

formTag. addFormElement (new Labeledlnput ( "age" , "Age: ")); 

formTag . addChild (new Break ( ) ) ; 

formTag . addChild (new Hiddenlnput ( " sid" , sid) ) ; 

formTag . addChild (new Hiddenlnput ( "dataEntered" , "Yes " ) ) 

formTag. addChild (new SubmitButton ("Submit")); 

bodyTag. addChild (formTag) ; 

htmlTag.addChild(bodyTag) ; 

return htmlTag . render ( ) ; 
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* Here is just a class that has some properties and methods, the main thing to mention is 

that 

* it implements Serializable , this is required to store data in UserProfile 
*/ 

public class Application2UserData implements java . io . Serializable 

private String preferences; 
private int age; 

public Application2UserData ( ) 

preferences = "None"; 
age = 0 ; 

public Application2UserData (String p, int a) 

preferences = p; 
age = a; 

public void setPref erences (String p) 
=: preferences = p ; 

public void setAge(int a) 
age = a; 

public String getPref erences ( ) 
return preferences; 

public int getAge () 
return age ; 
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import com . thinairapps . platform . connector . * ; 
import com . thinairapps . tag . html . * ; 
import com. thinairapps .platform. device . * ; 

import java .util . * ; 
import java.io.*; 
/** 

* This is the same as for Application 1, except different set of data for Application 2 
*/ 

public class Application2Connector implements Connector 
{ 

ConnectorAccess app2CA; 
String app2Path; 
String app2Name; 

public void init (String appName, String appPath, Properties connectorProps , 
ConnectorAccess ca, ApplicationLog al> 

app2CA = ca; 
app2Path = appPath; 
app2Name = appName; 



public String [] getDevicesO 

return new String [] {"TA_HTML"}; 



public void handle (Properties appProps, Device dev, OutputStream out) 

String sid; 
String usrName; 
String password; 
String result; 
String dataEntered; 

boolean valid; 
boolean userExists; 
Hashtable cache = null; 

sid = appProps .getProperty (" sid" ) ; 

dataEntered = appProps . getProperty (" dataEntered" ) ; 

valid = app2CA.sessionValid(sid) ; 

if (valid) 
{ 

//extract user information 

try 

{ 

cache = app2CA.getSessionCache (sid) ; 
} 

catch (Exception e) 
{ 

//catch NoSuchSessionException 



usrName = (String) cache . get ( "usr" ) ; 
password = (String) cache . get ( "pwd" ) ; 
//check to see if user exists 

userExists = app2CA.userProfileExists (usrName) ; 
//if he doesn't then prompt user to fill in fields 
Application2UserData app2UserEnteredData = null; 
try 
{ 

app2UserEnteredData = {Application2UserData) app2CA . getUserProf ileData (usrNameu?' 
, app2Name) ; 

} 
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* Here is just a class that has some properties and methods, the main thing to mention is \i 

that 

* it implements Serializable, this is required to store data in UserProfile 
*/ 

public class ApplicationlUserData implements java . io. Serializable 
{ 

private String ssNum; 

private String password; 

private String host; 

private String additional Param; 

public ApplicationlUserData { ) 
{ 

ssNum= "Unknown" ; 
password="None " ; 
host="n/a"; 

additionalParam= "n/a" ; 



public ApplicationlUserData (String ssn. String pw. String ht. String ap) 

ssNum = ssn; 
password = pw; 
host = ht; 

additionalParam = ap; 



public void setssNum (String ssn) 
ssNum = ssn; 



public void setPassword (String pw) 
password = pw; 



public void setHost (String ht) 
host = ht ; 



public void setAdditionalParam (String ap) 
additionalParam = ap; 



public String getssNumO 
return ssNum; 



public String getPassword ( ) 



public String getHostO 
return host ; 



public String getAddditionalParam () 
return additionalParam; 

} 
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import com. thinairapps .platform. connector , * ; 
import com . thinairapps . tag . html . * ; 
import com . thinairapps .platform . device . * ; 

import java.util.*; 
import j ava . io . * ; 



/** 

* This Connector is called from the main menu of the portal. It first checks to see if the 

session passed in is valid 

* Then it checks to see if the user is in User Profile, if their is an entry then display 

the data, if there isn't 

* then display the configuration field and have the user enter the data. There is a bit of 

a tricky part and the way 

* I've implemented is not the most robust way. The tricky part deals with if a user alreadyi^ 

has a User Profile, but from 

* another application. In that case it needs to check if the data in User profile is 

associated with this application 

* in particular. I've marked the code where the logic is taking place 
*/ 

public class ApplicationlConnector implements Connector 
{ 

ConnectorAccess applCA; 
String applPath; 
String applName ; 

public void init (String appName, String appPath, Properties connectorProps , 
ConnectorAccess ca, ApplicationLog al) 

{ 

applCA = ca; 
applPath = appPath; 
applName = appName ; 

} 

public String [] getDevices ( ) 
{ 

return new String [] {"TA_HTML"}; 

} 

public void handle ( Propert ies appProps , Device dev, OutputStream out) 

String sid; 
String usrName; 
String password; 
String result; 
String dataEntered; 

boolean valid; 
boolean userExists; 
Hashtable cache = null; 

//first get the SID, in this case the only way that a user should enter this \^ 
application is through the menu 

sid = appProps .getProperty ( "sid" ) ; 

//another variable to see where the user is 

dataEntered = appProps .getProperty ( "dataEntered" ) ; 

//check to see if the session is valid, it might have timed out.... 
valid = applCA. sessionValid{sid) ; 

if (valid) 
{ 

//extract user information 
//Now get the cache from the SID 
try 
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{ 

cache = applCA . getSessionCache ( sid) ; 
} 

catch (Exception e) 
{ 

//catch NoSuchSessionException 

} 

//retrieve the username and password 
usrName = (String) cache .get ( "usr" ) ; 
password = (String) cache . get ( "pwd" ) ; 

//Here's the TRICKY part, now we go and look to see if there is data associated ^ 
with this 

//application in particular. The method userProf ileExists does not tell us whichi^ 

application 
f / [i-i any) there is data for. 

userExists = applCA.userProf ileExists (usrName) ; 

ApplicationlUserData applUserEnteredData = null; 

try 

( 

//Here is where we try to see if there is data associated with this 
application 

applUserEnteredData = (ApplicationlUserData) applCA.getUserProf ileData (usrNamei^ 
, applName) ; 

} 

catch (Exception e) 
{ 

//catch NoSuchUserProf ileException 

} 

//Here we check 2 things 

//I) If the user does not exist, then it is his first time and display the 
configuration screen 

//2) Or he already exists, but the data is for another application, display the xf 

configuration screen for htis application 
if (luserExists | | applUserEnteredData == null) 
{ 

//check to see if data for user has been entered 

//this needs to be passed twice, once to check if user exists, then check \^ 

again for entering data 
if (dataEntered != null) 
{ 

//store user data 

//instatiate ApplicaitonlUserData 

ApplicationlUserData applUserData = new ApplicationlUserData () ; 
//Set the variables 

applUserData . setssNum(appProps .getProperty( "ssNum" ) ) ; 
applUserData. setPassword(appProps.getProperty("pwd") ) ; 
applUserData. setHost (appProps.getPropertyC'host") ) ; 

applUserData . setAdditionalParam (appProps . getProperty ( "additionalParam" ) ) ; 

//Ist create the user profile 
try 

//Here's another check, if the user already exists, and we are here that 
means 

//there was no data for this application, but we do not need to create 

another userprofile 
//so if the User does not exist, then create.... 
if ( luserExists) 
{ 

applCA.createUserProfile (usrName, password, applName); 

} 

//2nd now add the application data 

applCA. setUserProf ileData (usrName, applName, applUserData); 

} 

catch (Exception e) 
{ 

//catch exception for Prof ileAl ready Exists 
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//catch exception for Prof ileStoreLockedException 

} 

//Some HTML to tell the user that the data has been stored 
HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body { ) ; 

Paragraph pTag = new Paragraph!) ; 

pTag.addChild(new Text ( "Application 1 User Added")); 
pTag.addChild{new Break {)) ; 

pTag.addChild(new Text ("For User " + usrName) ) ; 
pTag.addChild(new Break ()) ; 
bodyTag. addChi Id (pTag) ; 

//View the data entered, incorporate the SID into the URL 

Anchor anl = new Anchor ( "View Data", applPath + "?sid=" + sid, new Text("Viewv? 

Data" ) > ; 
bodyTag . addChild (anl ) ; 
html Tag .addChild (bodyTag) ; 
try 

out . write ( html Tag . render { ) . getBytes () ) ; 
catch (Exception e) 

//catch out exception 



//Else the user does not exist 
result = renderlnputUserDataScr' 
try 
{ 

out .write (result .getBytes ( ) ) ; 
} 

catch (Exception e) 
{ 

//catch 10 excecption 

} 

iJ 

//if user exists and Application Data for this app exists that 1 

already is there 
//so display data to user 
{ 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ; 
Body bodyTag = new Body { ) ; 



Paragraph pTag = new Paragraph () ; 

pTag . addChild (new Text ( "Application 1 Data")); 
pTag . addChild (new Break ( ) ) ; 

pTag . addChild (new TextC'For User " + usrName)); 
pTag . addChild (new Break ( ) ) ; 
bodyTag. addChild (pTag) ; 

bodyTag . addChild (new Text ("Social Number: " + applUserEnteredData . \^ 

getssNum ( ) ) ) ; 
bodyTag. addChild (new Break ()) ; 

bodyTag.addChild (new Text ("Password: " + applUserEnteredData . getPassword 
() ) ) ; 

bodyTag.addChild (new BreakO); 

bodyTag.addChild (new Text ("Host: " + applUserEnteredData. getHost ())) ; 
bodyTag. addChild (new BreakO ) ; 
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bodyTag.addChild (new Text ("Additional Parameter: " + applUserEnteredData . 

getAddditionalParamO ) ) ; 
bodyTag . addChild (new Break ( ) ) ; 

bodyTag.addChild (new Text ("This data is now stored in UserProfile and cani^ 
be retrieved at any time with the Login and Password<br>" ) ) ; 

Anchor anl = new Anchor ( "Menu" , "/portal?f irstTime=l&sid=" + sid, new 
Text ("Return to Portal Menu")); 

bodyTag. addChild (anl) ; 

htmlTag. addChild (bodyTag) ; 

try 

{ 

out . write ( htmlTag . render ( ) . getBytes ( ) ) ; 
} 

catch (Exception e) 
{ 

//catch out exception 

} 



} 

else 

String result2 = "Sorry Session is not valid or Timed Out, please login again"; 

try 

{ 

out. write (result2. getBytes 0 ) ; 
} 

catch (Exception e) 

{ 

} 



public String renderlnputUserDataScreen (String sid) 
{ 

HTMLTagDocument htmlTag = new HTMLTagDocument ( ) ,- 
Body bodyTag = new BodyO ; 

Paragraph pTag = new Paragraph ( ) ; 

pTag. addChild (new Text("Please configure Application 1")); 

pTag. addChild (new Break () ) ; 

pTag. addChild (new Text("Enter Data")); 

pTag. addChild (new Break {) ) ; 

bodyTag . addChild (pTag) ; 

Form formTag = new Form ("UserData", applPath, "POST"); 

formTag.addFormElement (new Labeledlnput ( " ssNum" , "Social Security Number: ")); 
formTag . addChild (new Break ( ) ) ; 

PasswordField pwdlnput = new PasswordField ( "pwd" ) ; 

formTag. addChild (new Text (" Password : ")); 
formTag . addFormElement (pwdlnput) ; 
formTag. addChild (new Break () ) ; 

formTag . addFormElement (new Labeledlnput ( "host" , "Host: ")); 
formTag. addChild (new BreakO) ; 

formTag.addFormElement (new Labeledlnput ( "additionalParam" , "Additional Parameter 
: " ) ) ; 

formTag . addChild (new BreakO); 

formTag . addChild (new Hiddenlnput ( " sid" , sid) ) ; 

formTag. addChild (new Hiddenlnput { "dataEntered" , "Yes") ) ; 

formTag . addChild (new SubmitButton ("Submit")); 
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bodyTag . addChild { f ormTag) ; 
html Tag. addChild(bodyTag) ,- 
return htmlTag . render () ; 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWAR\E LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com. thinairapps .platform. * ; 
import com. thinairapps .pi at form. device . * ; 
import com. thinairapps .platform. connector . * ; 
import com. thinairapps . platform. exception . * 
import com. thinairapps .platform. provider. *; 

//rendering packages used to build markup 
import com. thinairapps . tag. * ; 
import com. thinairapps . tag. wml . * ; 
//import com. thinairapps . tag .html . * ; 

// the groupware packages 

import thinairapps , groupware . api . * ; 

import thinairapps .groupware . api . actions . * ; 

import thinairapps .groupware .api .bounds . * ; 

import thinairapps .groupware .api . exception. * ; 

; -import j ava . ut i 1 . * ,- 
^gimport java.io.*; 

/**This sample illustrates the use of the Customltem type to handle data in custom-created 

* folders and databases . 

* This sample renders WML. It prompts the user to choose one of two actions: add (create a \^ 

* item in the specified folder) , or read (get the field names and values in the first item 

found 

* within that folder, and display a group of them on the screen) . 

* The login data (provider name, host name, username, password) , the name of the template/ in- 

form for 

* the custom item folder, the name of the folder and (for a Lotus Domino item) the name of yr 

the 

* database, are all specified within the connector.ini file. 

* For a comprehensive reference of the Groupware Library see the ThinAir Groupware javadocs. 
*/ 

public class CRMConnector implements Connector 
{ 

// The friendly name of this sample app 
protected String appName,- 

//The path that needs to be appended to the server URL to access the app 
static String path; 

// Our access point to the services of ThinAir Server 
protected ConnectorAccess access; 

// The application log 

protected com. thinairapps . platform . connector . ApplicationLog log; 

/ / The provider 

protected String provider; 

// The user's login data 

protected String host, userName, password; 

// The location of the custom item folder within the Groupware store. 
// This should not be a global variable in a real connector, 
protected String location; 

// The name of the form/template that this custom folder uses - 
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// this variable is not actually used in any of this connector's code; however 
// it was included because it would be used by any real connector dealing with 
// Customltems, to add new items. See the comments within the addCustomltem ( ) 
// method for details 
static String formName = null; 

protected String sessionid = null; 



tants 

String DISPLAY_ACTION = "disp; 
String ACTION_FIELD = "action 
String LOGIN_ACTION = "login" 
String CREATE_ACTION = "add" ; 
String READ_ACTION = "read"; 



static 


Device 


//Actic 


3n const 


static 


final ; 


static 


final i 


static 


final ; 




final ; 


static 


final i 


static 


final J 




final i 


static 


final i 


static 


final ! 


static 


final ! 


static 


final ; 




final ; 




final ; 



"edit" ; 
= "update" 



■ing VIEW_By_I]!JDUSTRY="ByIndustry" ; 
■ing VIEW_BY_SALESCONTACT= "BySalesContact " 

c final String ELEMENT_NUMBER = "elemnutn"; 

//By Status Constants 

static final String STS_NEEDS_FIRST_CONTACT = "NFC"; 
static final String STS_NEEDS_FOLLOWUP = "NFU" ; 
Static final String STS_NEEDS_CREDIT_APPROVAL = "NCA"; 
static final String STS_NEEDS_TO_BE_INVOICED = "NTBI"; 
Static final String STS_CREDIT_APPROVED = "CA" ; 
static final String STS_INVOICE__SENT = "IS"; 
static final String STS_CREDIT_DENIED = "CD"; 
static final String STS_DEAD_END = "DE"; 

//By Industry Constants 

static final String I_ADVERTISING = "ADV" ; 
static final String I_CONSULTING = "CON"; 
static final String I_ENTERTAINMENT = "ENT" ; 
static final String I_FINANCE = "FIN"; 
static final String I_GOVERNMENT = "GOV"; 
static final String I_HEALTHCARE = "HEA" ; 
static final String I_MANUFACTURING = "MAN"; 
static final String I_RETAIL = "RET"; 

//By Sales Contact Constants 

static final String SC_MIKHAIL_BULGAKOV = "MB"; 
static final String S C_NE I L_D I AMOND = "ND"; 
Static final String SC_SAM_DONALDSON = "SD"; 
static final String SC_RICHARD_FEYNMAN = "RF" ; 
static final String SC_JOE_FRAZIER = "JF"; 
static final String SC_ARTHUR_RIMBAUD = "AR" ; 
static final String SC_LEON_TROTSKY = "LT" ; 
static final String SC_MICHELLE_YEOH = "MY"; 



* initO is called by the ThinAirServer when the Connector is loaded. It provides the 1/ 

connector with 

* resources it needs to interact with the ThinAirServer. 

* For more information about the Connector interface, see the javadocs for the ThinAir 

Server API 

* @param applicationName is a String derived from connector.ini. 

* Oparam applicationPath is a String derived from connector.ini. We don't need this fori^ 

this sample. 

* ©param connectorProps is a Properties list containing developer assigned 1^ 
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connector-specific properties. 
* @param connectorAccess is our access point to the services provided by ThinAir Server. 

public void init (String applicationName, String applicationPath, Properties 
connectorProps , 

ConnectorAccess connectorAccess, com. thinairapps .platform. connector . 
ApplicationLog appLog) throws ConnectorlnitException 

this. path = applicationPath; 
this.appName = applicationName; 
access = connectorAccess; 
log = appLog ; 

// the two strings from connector.ini that we'll use to create the official 
// "location" string. database is for Domino only 
String folder, database; 

// get provider name, as well as all login data, location of the custom folder, and 
// the name of the f orm/template being used, from the properties list (connector.ini) 
// Provider has to be either Exchange or Domino 
provider = connectorProps .getProperty ( "Provider" ) ; 

0) throw new ConnectorlnitException (iNo Provider entry in ^ 
host = connectorProps .getProperty ( "Host ") ; 

if (host. length 0 == 0) throw new ConnectorlnitException ( "No Host entry in connector. kT 



userName = connectorProps .getProperty ( "UserName" ) ; 

if (userName . length 0 == 0) throw new ConnectorlnitException ( "No UserName entry in 
password = connectorProps . getProperty ( "Password" ) ; 

if (password. length () == 0) throw new ConnectorlnitException ( "No Password entry in ^ 
connector . ini " ) ; 

folder = connectorProps .getProperty ( "Folder" ) ; 

if (folder. length 0 == 0) throw new ConnectorlnitException ( "No Folder entry in ^ 
connector . ini " ) ; 

database = connectorProps . getProperty ( "Database" ) ; 

// no exception thrown if user didn't include the name of the database - this may or 
may 

// not be a necessity for the groupware store being accessed. In the case of the 
groupware 

// providers that come with the ThinAir Server, the Domino provider requires one, 

while the 
// Exchange provider doesn't 

// now, set the location string - if no database name was included, then location 
// will just be equal to the folder name 
if (database . length ( ) == 0) 

location = folder; 

} 

el se 
{ 

//a database name was included; since we have only a single String to represent 
// the location within the eventual data request, how do we get both the folder 
// and the database name into this one String? Thankfully, there's a utility in 
// the Customltem class that takes care of it for us 

location = Customltem . LocNameUt lis . createLocationString (database , folder); 



forraName = connectorProps . getProperty (" FormName" ) ; 

//no exception thrown if user didn't include the name of the folder's form/template; 
// a Customltem connector can function without it, although not as well 
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/**getDevices 0 is called once by the ThinAir Server during start-up. It allows a 
Connector to 

* indicate the types of devices it supports. getDevicesO returns an array containing 

the names of all 

* DeviceProf lies supported by this Connector. These names are the friendly names used 

to uniquely 

* identify every DeviceProf ile . To get the friendly name of a particular device, refer 

to the ThinAir 

* Server Developer Guide or call DeviceProf ile ' s getNameO method. 

* For more details about device detection and handling see the DeviceDetective sample ii? 

connector and the 

* ThinAir Server Developer Guide. 

* ©return an array of Strings representing the friendly names of the devices this ^ 

Connector supports. 

*/ 

public String [] getDevicesO 
{ 

String devices [] = {WAPDeviceProf ile .NAME, HTMLDeviceProf ile -NAME, PalmVIIDeviceProfilei^ 
.NAME, OraniSkyDeviceProf ile. NAME} ; 

return devices; 

} 



/**The handle method implements the core logic of a Connector. It takes an incoming ^ 
request from a 

* particular device, and returns an appropriate response. This method is called whenever)^' 

* receives a request from a type of device that the Connector indicates it supports, 

destined (as 

* indicated in the request URL) for a specific application. It is the responsibility of ^ 

the Connector 

* to interpret the request and generate an appropriate response. 

* The server will pass a Device object containing as much information as possible into 

this method. 

* The Connector can then utilize the particular Device class to determine more detailed 

information 

* on the capabilities of the particular device making the request. 

* @param props a set of name value pairs corresponding to the HTTP request parameters 1/ 

from the device. 

* ©param device a Device object created in the image of the actual device making this 1^ 

request . 

* Oparam result a reference to the OutputStream that will be returned to the device. 
*/ 

public void handle (Properties props. Device device, OutputStream result) throws i^" 
lOException 



String resultString = null; 

//Set the device equal to the global variable for device 
CRMConnector .g_DEVICE = device; 

//The cache for this session 
Hashtable cache = null; 

//get the 'action' parameter from the request. This is an HTTP param we define to \^ 

determine what action 
//to take when we get a request. 
String action = props .getProperty (ACTION_FIELD) ; 
String view = props . getProperty (ELEMENT_NUMBER) ; 
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try 

if (action == null) 
{ 

// if this is the first hit (or any request for the main deck) . . . 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderStartScreen ( ) ; 

else 

resultString = CRMHTMLRenderer . renderStartScreen () ; 

} 

//If all the elements on the form have been filled out, then display it 

else if (action. equals (DISPLAY ACTION) ) 

{ 

addCustomltem (location, sessionid, props) ; 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderMessage ( "The form has been in- 
completed" ) ; 

else 
{ 

resultString = CRMHTMLRenderer. renderMessage ( "The form has been \/ 
completed") ; 

} 

} 

else if (action. equals (LOGIN_ACTION) ) 
{ 

sessionid = loginUser (provider, host, userName, password) ; 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderOptionMenu () ; 

else 

resultString = CRMHTMLRenderer. renderOptionMenu () ,- 

} 

else 
{ 

if (action. equals (CREATE_ACTION) ) 

{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderlnputForm ( ) ; 

else 

resultString = CRMHTMLRenderer . renderlnputForm () ; 

} 

else if (action. equals (VIEW ACTION) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderAvailableViews () ; 

else 

resultString = CRMHTMLRenderer . renderAvailableViews () ; 

} 

//One must view an item before they edit it, so we set certain important 

//the view item section 

else if (action. equals (EDIT_ACTION) ) 

{ 

String editViewParam = props .getProperty ( "editPrm" ) ; 

//From the URL, determine which element they want to see.. 
Integer prelimNumber = new Integer (0); 
int elementNumber ; 

elementNumber = (prelimNumber .parseint (editViewParam) ) ; 

//Get the cache for this session 

cache = access . getSessionCache ( sessionid) ; 

//Retrieve the Store Items that we've already placed into the cache 
//A Storeltems is a Vector 

Storeltems customltems = ( (Storel terns ) cache . get (" storeitems ")) ; 
//Retrieve the particular item that we want 

Customltem item = ( (Customltem) (customltems . elementAt (elementNumber) )) ,- 
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//Also get the message ID 

Storeltem storeltem = { (Storeltem) ( customi terns .elementAt 

(elementNutnber) ) ) ; 
String messagelD = storeltem. getID {) ; 

//Render the Item 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . editltem(item, messagelD) ; 

else 

resultString = CRMHTMLRenderer . edit Item ( item, messagelD) ; 

} 

else if (action. equals (UPDATE_ACTION) ) 
{ 

//Update the Item 

updateCustomltem (location, sessionid, props) ; 

//Render the message 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderMes sage ( "Item has been updated"),- 

else 

resultString = CRMHTMLRenderer . renderMessage (" Item has been 
updated" ) ; 



e if (action. equals (VIEW_BY_STATUS) ) 

Storeltems customltems = getCustomltems (location, sessionid); 

//Get the cache for this session 

cache = access .getSessionCache (sessionid) ; 

//Put the returned Storeltems into the cache 
cache .put ( "storeltems" , customltems) ; 

//render the fields of this object 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . renderView (customltems , 
VIEW_BY_STATUS) ; 

else 

'enderView (customltems , 

le if (action. equals (VIEW_BY_INDUSTRY) ) 

Storeltems customltems = getCustomltems (location, sessionid) ; 

//Get the cache for this session 

cache = access .getSessionCache (sessionid) ; 

//Put the returned Storeltems into the cache 
cache .put ( "storeltems" , customltems) ; 

//render the fields of this object 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer. renderView (customi terns, 
VIEW_BY_INDUSTRY) ; 

else 

. renderView (customltems , 

e if (action. equals (VIEW_BY_SALESCONTACT) ) 

Storeltems customltems = getCustomltems (location, sessionid); 

//Get the cache for this session 

cache = access .getSessionCache (sessionid) ; 

//Put the returned Storeltems into the cache 
cache .put ( "storeltems" , customltems ) ; 
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//render the fields of this object 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer.renderView(customItems, 

VIEW_By_SALESCONTACT) ; 

else 

resultString = CRMHTMLRenderer . renderView (customltems , 
VIEW_BY_SALESCONTACT) ; 

} 

//Determine what Customer Status view the user selected 

else if (action. equals ("NFC") ) 

{ 

if (device instanceof WAPDevice} 

resultString = CRJ4WMLRenderer .viewByField ( "Needs First Contact", i^r 
access, sessionid) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Needs First Contact", i^* 
access, sessionid) ; 

} 

else if (action. equals ( "NFU" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Needs Follow-Up", access, i^* 
sessionid) ; 

else 

resultString = CRMHTMLRenderer.viewByField( "Needs Follow-Up", access 

} 

else if (action. equals ( "NCA" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer.viewByField("Needs Credit Approval", 
access, sessionid) ,- 

else 

resultString = CRMHTMLRenderer . viewByField ( "Needs Credit Approval", \^ 
access, sessionid) ,- 

} 

else if (action. equals ("NTBI ") ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer.viewByField( "Needs to be Invoiced", 
access, sessionid) ; 

resultString = CRMHTMLRenderer . viewByField ( "Needs to be Invoiced", «f 
access, sessionid) ; 

} 

else if (action. equals ("CA") ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Credit Approved", access, 
sessionid) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Credit Approved", access 
, sessionid) ,- 

) 

else if (action. equals (" IS" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField (" Invoice Sent", access, \t 
sessionid) ; 

else 

resultString = CRMHTMLRenderer. viewByField ( "Invoice Sent", access, 
sessionid) ; 

} 

else if (action. equals ( "CD" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Credit Denied", access, »^ 
sessionid) ; 
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else 

resultString = CRMHTMLRenderer .viewByField ( "Credit Denied", access, wT 
sessionid) ; 

else if (action. equals ("DE") ) 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Dead End", access, 
sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField { "Dead End", access, 
sessionid) ; 

/Determine what Industry field the Customer selected 
Ise if (action. equals ("ADV") ) 

if (device instanceof WAPDevice) 

resultString = CRMWMIjRenderer.viewByField( "Advertising" , access, kT 
sessionid) ; 

else 

resultString = CRMHTMLRenderer.viewByField( "Advertising" , access, ^ 
sessionid) ; 

Ise if (action. equals ( "CON" ) ) 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField (" Consulting " , access, 
sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField ( "Consulting" , access, i^ 
sessionid) ; 

ilse if (action. equals ( "ENT" ) ) 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Entertainment " , access, 
sessionid) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Entertainment " , access, 
sessionid) ; 

ilse if (action. equals("FIN") ) 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField (" Finance" , access, k? 
sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField ( "Finance " , access, 
sessionid) ; 

else if (action. equals ( "GOV" ) ) 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Government " , access, \^ 
sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField ( "Government " , access, \^ 
sessionid) ; 

Ise if (action. equals ( "HEA") ) 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Healthcare " , access, \^ 
sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField ( "Healthcare" , access, k? 
sessionid) ; 

} 

else if (action. equals ( "MAN" ) ) 
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{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer.viewByField( "Manufacturing" , access, 1^ 
sessionid) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Manufacturing" , access, 
sessionid) ; 

} 

else if (action. equals ( "RET" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Retail " , access, 1^ 
sessionid) ; 

else 

resultString = CRMHTMLRenderer . viewByField ( "Retail " , access, \^ 
sessionid) ; 

} 

//Determine what Sales Contact Field the Customer selected 

else if (action. equals ("AR") ) 

{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Arthur Rimbaud", access, ^ 
sessionid) ; 

resultString = CRMHTMLRenderer.viewByField( "Arthur Rimbaud", access, )i 
sessionid) ; 

} 

else if (action. equals ("JF") ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer. viewByField ( "Joe Frazier", access, ^ 
sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField ( "Joe Frazier", access, ^ 
sessionid) ; 

} 

else if (action. equals ("LT") ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer. viewByField( "Leon Trotsky", access, ^ 

else 

resultString = CRMHTMLRenderer . viewByField ( "Leon Trotsky", access, 
sessionid) ; 

} 

else if (action. equals ( "MY" ) ) 

{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Michelle Yeoh" , access, 1^ 
sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField ( "Michelle Yeoh", access, 1^ 
sessionid) ; 

} 

else if (action. equals ( "MB" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Mikhail Bulgakov", access 
, sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField ( "Mikhail Bulgakov", accessi^ 
, sessionid) ; 

} 

else if (action . equals ( "ND" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Neil Diamond", access, ^ 
sessionid) ; 

else 
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resultString = CRMHTMLRenderer . viewByField ( "Neil Diamond", access, 
sessionid) ; 

} 

else if (action . equals ( "RF" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer .viewByField ( "Richard Feynman", access, 
sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField ( "Richard Feynman", access 
, sessionid) ; 

} 

else if (action. equals ( "SD" ) ) 
{ 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer . viewByField ( "Sam Donaldson" , access, 
sessionid) ; 

else 

resultString = CRMHTMLRenderer .viewByField ("Sam Donaldson", access, 
sessionid) ; 

} 

//Call the method that renders the fields of the selected item 

else if (action. equals (CRMConnector. VIEW__BY_FIELD_ACTION) ) 

{ 

Integer prelimNumber = new Integer (0) ; 
int elementNumber; 

elementNumber = (prelimNumber .parseint (view) ) ; 

//Get the cache for this session 

cache = access .getSessionCache (sessionid) ; 



String itemKey="ItemViewed" ; 
cache.put (itemKey, view) ; 

//Retrieve the Store Items that we've already placed into the cache 
//A Storeltem is a Vector 

Storeltems customltems = ( (Storel terns ) cache . get ( "storeitems ")) ; 
//Retrieve the particular item that we want 

Customltem item = ( (Customltem) (customltems . elementAt (elementNumber) )) ; 
//Render the Item 

if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer. renderCustomltemFields (item, access, 
sessionid) ; 

else 

resultString = CRMHTMLRenderer . renderCustomltemFields ( item, access, 
sessionid) ; 

} 

} 

} 

catch (Exception e) 
{ 

e . printStackTrace ( ) ; 

// Here, we employ a primitive solution of simply displaying the error message 

and providing a link 
// back to the welcome screen; a larger app would handle each error separately 

and navigate the 
// user accordingly 
if (device instanceof WAPDevice) 

resultString = CRMWMLRenderer - renderMessage (e . getMessage ()) ; 

else 

resultString = CRMHTMLRenderer . renderMessage (e . getMessage ()) ; 

} 

// in this example we logged on, performed a simple action, then logged off again. P, 
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more 

// complete app might hold the session open between requests, and cache the retrieved 
// Storeltems in the session cache, using this to feed item bodies out to the client 
// without going to the provider each time 
byte[] resultBytes = resultString . getBytes () ; 
result .write (resultBytes) ; 



/**loginUser 0 logs in the user to a groupware store using the specified login data 

* ©pararn providerName the name of the provider being used to access the message sto: 

* @param host the IP or server name of the message store. 

* Oparam userName the user name of the account being logged onto. 

* ©param password the password for this user. 

* ©return a providerSessionId if success; otherwise an error will be thrown. 
*/ 

protected String loginUser (String providerName, String host. String userName, 
String password) throws Exception 



{ 



String SID = null; 



try 
{ 



// Create a new Session with the specified provider and returns a unique Session 
ID. 

SID = access .createProviderSession (providerName); 

// Get the providerProxy associated with the session we just created, 
// this is what is used to interact with the Provider 
StoreProviderProxy spLite = access . getStoreProvider (SID); 

// Create a StoreProviderLogin object, this defines the action the provider will 
execute 

StoreProviderLogin login = new StoreProviderLogin (userName, password, host) ; 

// use the providerProxy to login. The provider returns the items it supports 
Supportedltems supports = spLite . connectUser (login) ; 

// check to make sure that this provider handles Customltem objects 

boolean supportsCust Items = false; 

Enumeration supportedEnum = supports . getltems () ; 

while ( supportedEnum. hasMoreElements ( ) ) 

Supportedltem curltem = (Supportedltem) supportedEnum. nextElement () ; 
if (curltem. getType ( ) == ItemTypes . CUSTOM_lTEM) 
supportsCustltems = true; 

} 

// if it doesn't handle Customltem objects, throw an exception 
if (! supportsCustltems) 

throw new Exception ( "Specif ied provider (" + providerName + ") does not 
support Customltem handling"); 



} 

catch (NoSuchProviderExcepti* 



loaded by the 



/**getCustomItems () retrieves items from a groupware location, and returns a 
* Customlteras object containing all its information 
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* ©param location The location in the groupware store being accessed 

* @param SID The session ID for the user's connection to the groupware store 

* ©return a Customltetn representing the first item in the folder 
*/ 

protected Storeltems getCustomltems (String location, String SID) throws Exception 
{ 

String resultString; 

ItemRequest iReq = new ItemRequest (); 
iReq. itemType = ItemTypes . CUSTOM_ITEM; 
iReq. itemLocation = location; 

//Use -1 to specify no maximum limit 

iReq. max = -1; 

iReq. start ID = null ; 

iReq. bounds = null; 

UserDataRequest udReq = new UserDataRequest (); 
udReq. requests = new ItemRequest [1] ; 
udReq. requests [0] = iReq; 

UserData uData = access .getStoreProvider (SID) .getUserData (udReq) ; 
ItemRequestResponse irr = uData. responses [0] ; 
Storeltems customltems = irr. items; 

return customltems; 

} 



/**addCustomItem( ) adds an item to a groupware location containing custom- 

* defined items 

* ©param location The location in the groupware store being accessed 

* ©param SID The session ID for the user's connection to the groupware store 
*/ 

protected void addCustomltem (String location. String SID, Properties props) throws \i 
Exception 

try { 

//Create a custom item 

//String formName = "IPM. Contact .Sample" ; 
//String formName = "Sample"; 
/ /YTom. Connector.ini 

//String formName = connectorProps .getProperty ( "FormName ") ; 
//String providerName = "Domino"; 

Customltem custltem = new Customltem (ItemTypes . CONTACT, formName); 

//Example of how to set the standard fields of a custom Item 
//Each Customltem has a Standardltem included within it 
//Contact testContact = new Contact () ; 
//custltem. setStandardltem (testContact) ; 
//testContact. setFullName( "Rudy Guliani") ; 

//Set the time 

Calendar cal = Calendar . getlnstance () ; 

cal . setTime (new Date ( ) ) ; 

Date todayTime = cal . getTime ( ) ; 

String timeString = todayTime . toString () ; 

custltem. addField (" ItemCreated" , txmeString) ; 

//If its a Domino Provider, then set the "Form" field to the form name 
//Future iterations of the Domino Provider will do this automatically 
if (provider . equals ( "Domino" ) ) 
{ 

custltem . addField ( "Form" , formName) ; 

} 
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//Set the fields of that item 

custltera.addFieldC'CustomerName", props. getProperty ( "cstnm" ) ) ; 
custItem.addField( "Position" , props .getProperty ( "psn" ) ) 
custltem.addField ( "CompanyName" , props . getProperty ( "cnm" ) ) ; 

//Industry 

String industry = props .getProperty (" industry" ) ; 

String [] industryURLParams = {"a", "b" , "c", "d" , "e","f 
String [] industries 

= { "Advertising" , "Consulting" , "Entertainment" , "Finance 

, "Manufacturing" , "Retail" } ; 
int i; 

for (i = 0; i < 8; i++) 
{ 

if (industry. equals ( industryURLParams [i] ) ) 
{ 

custltem.addField ( "Industry" , industries [il ) ; 

} 

I 

//Sales Contact 

String salescontact = props .getProperty ( "sc" ) ; 
String [] salesContactURLParams = {"a", "b" , "c", "d", " e " , " f " , "g " , "h" } ; 
String [] salescontacts = {"Mikhail Bulgakov" , "Neil Diamond" , "Sam Donaldson" , "Richard \tt 
Feynman" , " Joe Frazier" , "Arthur Rimbaud" , "Leon Trotsky" , "Michelle Yeoh"}; 

for (i = 0; i < 8; i++) 
{ 

if (salescontact . equals (salesContactURLParams [i] ) ) 
{ 

custItem.addField( "Salescontact" , salescontacts [ i] ) ; 

} 

} 

//Account Number 

custItem.addField("AccountNumber" , props .getProperty ( "an" ) ) ; 
//Customer Status 

String customerStatus = props . getProperty ( "custstatus" ) ; 

String [] customerStatusURLParams = {"a", "b", "c", "d", "e" , "f " , "g" , "h" } ; 

String [] customerStatusVals = {"Needs First Contact ", "Needs Follow-Up" , "Needs Credit kf 

Approval ", "Needs to be Invoiced" Credit Approved" ," Invoice Sent ", "Credit 

Denied" , "Dead End" } ; 

for (i = 0; i < 8; i++) 
{ 

if (customerStatus . equals (customerStatusURLParams [i] > ) 
{ 

custItem.addField( "CustomerStatus" , customerStatusVals [i] ) ; 
break; 



","g","h"}; 

" , "Government" , "Healthcare" 



// set the location of the new item to be the user-specified location 
custltem. setLocaticnlnStore (location) ; 

StoreProviderProxy spProxy = access .getStoreProvider (SID) ; 
AddNewGroupwareltem addAction = new AddNewGroupwareltem ( custltem) ; 
spProxy . doUserDataAction (addAction) ; 

} 

catch (Exception e) 
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{ 

System. out . println ("Error adding the item: " + e); 



/**addCustomItem() adds an item to a groupware location containing custom- 

* defined items 

* @param location The location in the groupware store being accessed 

* @param SID The session ID for the user's connection to the groupware store 

* @param props The properties object containing the request 
*/ 

protected void updateCustomltem (String location, String SID, Properties props) throws 
{ 

^ry 

//Create a custom item 

//String formName = " I PM . Contact . Sample" ; 
//From Connector.ini 

String formName = props .getProperty ( "FormName" ) ; 
//Get the messagelD 

String messagelD = props . getProperty ( "MessagelD" ) ; 

//Create the new Customltem object. We're using it only as a container. 
Customltem custltemContainer = new Customltem (I temTypes. CONTACT, formName) ; 



//Set the fields of that item 

custltemContainer . addField ( "CustomerName" , props . getProperty (" cstnm" ) ) ; 
custltemContainer .addFieldC "Position" , props . getProperty ( "psn" ) ) ; 
custltemContainer . addField( "CompanyName" , props .getProperty ( "cnm" ) ) ; 

//industry 

String industry = props .getProperty ( "industry" ) ; 

String [] industryXJRLParams = {"a", "b", "c", "d" , "e" , "f " , "g" , "h" } ; 
String [] industries 

= { "Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Healthcare" 
, "Manufacturing" , "Retail" } ; 
int i ; 

for (i = 0; i < 8; i++) 
{ 

if (industry. equals ( industryURLParams [i] ) ) 
{ 

custltemContainer. addField ("Industry", industries [i] ) ; 
break ,- 




//Sales Contact 

String salescontact = props .getProperty ( "so" ) ; 

String [] salesContactURLParams = {"a", "b", "c", "d", "e" , "f " , "g" , "h" } ; 
String [] salescontacts = {"Mikhail Bulgakov" , "Neil Diamond" Sam Donaldson" , "Richard ^ 
Feynman" , "Joe Frazier" , "Arthur Rimbaud" , "Leon Trotsky" , "Michelle Yeoh" ) ; 

for (i = 0; i < 8; i++) 
{ 

if (salescontact . equals (salesContactURLParams [i] ) ) 
{ 

custltemContainer . addField ( "Salescontact " , salescontacts [i] ) ; 
break ; 

} 

} 
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//Account Number 

custltemContainer . addField ( "AccountNumber" , props .get Property ( "an" ) ) ; 
//Customer Status 

String customerStatus = props .getProperty( "custstatus") ? 

String [] customerStatusURLParams = {"a", "b", "c", "d", "e" , " f " , "g" , "h" } ; 

String[] customerStatusVals = {"Needs First Contact ", "Needs Follow-Up" , "Needs Credit \^ 

Approval ", "Needs to be Invoiced" , "Credit Approved" , "Invoice Sent" , "Credit ^ 

Denied" , "Dead End" } ,- 

for (i = 0; i < 8; i++) 
{ 

if (customerStatus .equals (customerStatusURLParams [i] ) ) 
{ 

custltemContainer .addField("CustomerStatus" , customerStatusVals [i] ) ; 

} 

} 

//New Contact object - this will be Customltem' s standard item 
Contact actualContact = new ContactO; 
custltemContainer . setStandardltem (actualContact ) ; 

// set the location of the new item to be the user- specif ied location 
custltemContainer. setLocationlnStore (location) ; 

StoreProviderProxy spProxy = access .getStoreProvider (SID) ; 

//AddNewGroupwareltem addAction = new AddNewGroupwareltem(custltem) ,- 
//spProxy.doUserDataAction (addAction) ; 

SpProxy . doUserDataAct ion (new UpdateGroupwareltem (messagelD, location, \i 
custltemContainer) ) ; 

} 

catch (Exception e) 
{ 

System. out .println ("Error updating the item"); 

} 

} 

'I 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality- 
import com. thinairapps .platform. * ; 
import com. thinairapps . platform. device . * ; 
import com. thinairapps .platform. connector . * ; 
import com. thinairapps . platform. exception . * ; 
import com. thinairapps .platform. provider . * ; 

//ThinAir Tag Libraries imports 
import com. thinairapps . tag .* ; 
import com . thinairapps . tag . html . * ; 

// the groupware packages 

import thinairapps . groupware . api . * ; ' 
import thinairapps . groupware . api . actions . * ; 
import thinairapps . groupware . api . bounds . * ; 
import thinairapps . groupware . api . except ion . * ; 

//Standard Java imports 
import java.util.*; 



/** 

* This utility class renders output as HTML for a variety of devices 
*/ 

Class CRMHTMLRenderer 
{ 

/**This method renders a deck containing a welcome card 

* ©return the rendered deck. 
*/ 

static String renderStartScreen ( ) 
{ 

HTMLTagDocument doc = new HTMLTagDocument { ) ; 

com. thinairapps . tag . html . Head head = new com. thinairapps . tag .html .Head () ; 
if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector .g_DEVICE 

instanceof OmniSkyDevice) 

{ 

" PalmComputingPlatf orm" , "true") ; 

com . thinairapps . tag . html .Bold bold = new com . thinairapps . tag . html . Bold ( "Sample CRM 

Connector" ) ; 
head. addChild (bold) ; 
doc . setHead (head) ; 

Body body = new Body ( ) ; 

com. thinairapps. tag. html. Paragraph para = new com. thinairapps. tag. html. Paragraph () ; 
body . addChild (para) ; 

String href = CRMConnector .path + "?" + CRMConnector .ACTION_FIELD + "=" + 

CRMConnector . LOGIN_ACTION ; 
com. thinairapps . tag . html .Anchor anl = new com . thinairapps . tag . html .Anchor ( "Start " , 
href, new com . thinairapps . tag . html . Text { "Login" )) ,- 

body .addChild (anl) ; 

body .addChild (new com . thinairapps . tag . html . Break () ) ; 
doc . setBody (body) ; 

String resultString = doc . render {) ; 
return resultString; 
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* This method renders a deck with a card that lets the user specify which action to take 

* ©return the rendered deck. 

static String renderOptionMenu ( ) 
{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps.tag.html. Head head = new com. thinairapps . tag . html . Head () ; 
if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector . g_DEVICE 

instanceof OmniSkyDevice) 

{ 

Meta meta = new MetaC'name", "PalmComputingPlatform" , "true"); 

head.addChild(meta) ; 

} 

com. thinairapps. tag. html. Bold bold = new com. thinairapps . tag . html .Bold ( "Sample CRM 

Connector") ; 
head. addChild (bold) , • 
doc . setHead (head) ; 

Body mBody = new BodyO ; 

com. thinairapps. tag. html. Paragraph para = new com. thinairapps . tag. html . Paragraph () ; 
para. addChild (new com . thinairapps . tag . html . Text { "Please choose from the following 
...")); 

mBody -addChild (para) ; 

String href = CRMConnector .path + "?" + CRMConnector .ACTION_FIELD + "=" + ^ 

CRMConnector. CREATE_ACT ION + "&rnd=" + Math. random {) ; 
com. thinairapps. tag. html. Anchor anl = new com. thinairapps . tag .html .Anchor ( "Create" , >/• 

href, new com. thinairapps . tag . html .Text ( "Create a new Item")); 

mBody. addChild (anl) ; 

mBody. addChild (new com. thinairapps.tag. html .BreakO ) ; 

string href2 = CRMConnector . path + "?" + CRMConnector .ACTION_FIELD + " = " + i^" 

CRMConnector .VIEW_ACTION + "&rnd=" + Math . random () ; 
com. thinairapps . tag. html .Anchor an2 = new com . thinairapps . tag . html .Anchor (" Select " , ^ 

href2, new com. thinairapps .tag. html .Text ( "Select a View")); 

mBody. addChild(an2) ; 

mBody. addChild (new com. thinairapps . tag .html . Break () ) ; 
doc . setBody (mBody) ; 

String resultString = doc . render {) ; 
return resultString; 

} 



* Renders the fields of a single Customltem 

* ©param item the Customltem whose fields we should render 

* ©return the rendered deck. 
*/ 

static String renderCustomltemFields ( Customltem item, ConnectorAccess access. String 
sessionid) throws Exception 

{ 

//Get the cache for this session 
Hashtable cache=null; 

cache = access .getSessionCache (sessionid) ; 
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//Storing the item being viewed in the cache 
String itemViewed; 

itemViewed = cache . get ( "ItemViewed" )• toString () ; 
//Get the messagelD 

String messagelD = ( (Storeltem) item) .getID ( ) ; 

//create the deck 
String url = null; 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps.tag.html. Head head = new com.thinairapps.tag.html .Head () ; 
if (CRMConnector .g_DEVICE instanceof PalmVI IDevice | j CRMConnector . g_DEVICE 

instanceof OmniSkyDevice) 

{ 

Meta meta = new MetaC'name", "PalmComputingPlatf orm" , "true"); 

head.addChild(meta) ; 

} 

com. thinairapps . tag. html .Bold bold = new com. thinairapps . tag .html . Bold { "Sample CRM \i 

Connector") ; 
head. addChild (bold) ; 
doc . setHead (head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag .html . Paragraph para = new com. thinairapps . tag . html . Paragraph () ; 
para. addChild (new com. thinairapps . tag. html . Text (" Item Fields:")) ; 

mBody .addChild (para) ; 

// Now add the fields and their values: 

//first get the Data object that contains all the info about our custom fields. 
Data customFields = item . getCustoraFieldData () ; 

//Get an enumeration of the fields... 
Enumeration fieldEnum = customFields . getFields () ; 

// go through the fields, and add each one to the deck - we'll stop after 15, 
// to avoid any deck overflow problems 
int itemsDisplayed = 0 ; 

while (fieldEnum. hasMoreElements ( ) && itemsDisplayed < 15) 
{ 

String f ieldTextName = null; 
string fieldText Value = null; 

Field thisField = (Field) fieldEnum . nextElement () ; 

//We must check the type, because that determines how we retrieve the field 
if (thisPield.getType {) == Field. BOOLEAN_VAL) 

f ieldTextName = thisField . getName () ; 

f ieldTextValue = ": " + thisField. getBoolean () ; 

else if (thisPield.getType () == Field . DOtIBLE_VAL) 

f ieldTextName = thisField . getName () ; 

f ieldTextValue = ": " + thisField . getDouble () ; 

else if (thisPield.getType 0 == Field . INT_VAL) 

f ieldTextName = thisField . getName () ; 

f ieldTextValue = ": " + thisField . getint () ; 

else if (thisPield.getType ( ) == Field . LONG_VAL) 

f ieldTextName = thisField . getName () ; 

f ieldTextValue = ": " + thisField. getLong () ; 
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else if (thisField.getType () == Field . STRING_VAL) 

f leldTextName = thisField.getName ( ) ; 

f ieldTextValue = ": " + thisField.getString ( ) ; 

else if (thisField.getType 0 == Field. DATE_VAL) 

f ieldTextName = thisField.getName () ; 

f ieldTextValue = ": " + thisField.getDate ( ) ; 

//Transform the field name to the what we want to display as the field name 

//We do this because we want the actual field names in Domino or Exchange to have 

//no spaces, but we want the display names to have spaces (i.e. ^ 

CustomerName- -Customer Name) 
String f ieldDisplay=null ; 

if { f ieldTextName . equals ("CustomerName")) 

fieldDisplay=" Customer Name"; 
else if (f ieldTextName . equals ("Position")) 

f ieldDisplay= " Position" ; 
else if (f ieldTextName . equals ( " CompanyName " ) ) 

f ieldDisplay="Company Name"; 
else if (f ieldTextName . equals ("Industry")) 

f ieldDisplay="Industry" ; 
else if ( f ieldTextName . equal s ( " ItemCreated" ) ) 

f ieldDisplay=" Item Created"; 
else if (f ieldTextName. equals ("Salescontact")) 

f ieldDisplay="Sales Contact"; 
else if (f ieldTextName . equals ( "AccountNumber" ) ) 

fieldDisplay=" Account Number"; 
else if (f ieldTextName. equals ( "CustomerStatus" ) ) 

£ieldDisplay= "Customer Status"; 
//If there 'a a field on the form that we're not expecting, 
//don't display it 
else 
{ 

continue; 

} 

raBody.addChild(new Text (f ieldDisplay) ) ; 
mBody.addChild(new Text (f ieldTextValue) ) ; 

mBody.addChild(new BreakO); 
itemsDisplayed++ ; 

} 

//Dink Home 

String href = CRMConnector .path+ " ?rnd="+Math. random () ; 

com. thinairapps . tag .html -Anchor anl = new com.thinairapps.tag.html .Anchor ("Home" , ^ 
href, new com. thinairapps . tag . html .Text ( "Start Again...")); 

mBody.addChild (new com.thinairapps.tag.html .BreakO ) ; 
mBody.addChild(anl) ; 

mBody.addChild (new com. thinairapps .tag. html .Break () ) ; 
//Link to edit the Item 

String editHref = CRMConnector .path+" ? "+ CRMConnector .ACTION_FIELD + "=" + \^ 
CRMConnector . EDIT_ACTION + " & editPrm= " + itemViewed + " &amp ; rnd= " +Math . randomii' 
0 ; 

com. thinairapps . tag .html .Anchor an2 = new com . thinairapps . tag . html . Anchor ( "Edit " , ^ 
editHref, new com . thinairapps . tag . html . Text ( "Edit Item")); 

mBody.addChild (an2) ; 

mBody.addChild (new com . thinairapps . tag . html . Break ( ) ) ; 
doc. setBody (mBody) ; 

String resultString = doc . render () ; 
return resultString; 

} 
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/** This method renders a simple message, either an error or a success, 

* then links back to the main page 

* @param message the message to be presented to the user 

* ©return the rendered HTML deck 
*/ 

static String renderMessage (String message) 
{ 

HTMLTagDocument doc = new HTMLTagDocument { ) ; 

com. thinairapps .tag. html .Head head = new com. thinairapps . tag .html .Head {) ; 
if (CRMConnector .g_DEVICE instanceof PalmVI IDevice | [ CRMConnector . g_DEVICE 

instanceof OmniSkyDevice) 

{ 

Meta meta = new Meta("name", "PalmComputingPlatf orm" , "true"); 

head.addChild{meta) ; 

} 

com.thinairapps.tag.html -Bold bold = new com. thinairapps . tag .html . Bold ( "Sample CRM \i 

Connector" ) ,- 
head. addChild (bold) 
doc . setHead (head) ; 

Body body = new Body ( ) ,- 

com. thinairapps. tag .html . Paragraph para = new com. thinairapps . tag . html . Paragraph {) ; 
para .addChild (new com. thinairapps . tag . html . Text (message ) ) ; 
body.addChild(para) ; 

body. addChild (new com. thinairapps . tag . html .Break () ) ; 
//Link home 

String href = CRMConnector . path+ "? rnd= " +Math. random () ,- 

com. thinairapps . tag .html .Anchor anl = new com . thinairapps . tag . html .Anchor ( "Start " , liT 
href, new com.thinairapps.tag.html .Text ("Start again...")); 

body. addChild (anl) ; 

body. addChild (new com. thinairapps .tag .html .Break () ) ; 
doc . setBody (body) ; 

String resultString = doc. render (); 
return resultString; 

} 



/** 

* This method renders a deck with several cards including a welcome card and card for yC 

entering information 

* This method makes use of the ThinAir HTML Tag Library for HTML markup creation. For ^ 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server 

Development Guide. 

* @return the rendered deck. 
*/ 

static String renderlnputForm ( ) 
{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com . thinairapps . tag . html . Head head = new com. thinairapps . tag . html . Head () ; 
if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector .g_DEVICE 

instanceof OmniSkyDevice) 

{ 

Meta meta = new Meta("name", "PalmComputingPlatf orm" ^ "true"); 

head. addChild (meta) ; 

} 
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com.thinairapps.tag.html .Bold bold = new com . thinairapps . tag . html . Bold ( "Sample CRM \t 

Connector" ) ; 
head. addChild (bold) ; 
doc. setHead( head) ; 



Body body = new Body ( ) ; 

com. thinairapps . tag .html . Paragraph para = new com. thinairapps. tag. html. Paragraph () ; 
body. addChild (para) ; 

//Create the form 
string href="/crm"; 

com. thinairapps . tag -html . Form inputForm = new com. thinairapps. tag. html. Form ("Sample ^ 
Form" , href , "POST") ; 



//CreaLt& the inputs and selects 
com. thinairapps . tag .html .Labeledlnput custName 
Name : " ) ; 

com. thinairapps . tag .html .Labeledlnput psnName = 
com . thinairapps . tag . html . Labeledlnput corapName 
Name -. " ) ; 

com. thinairapps . tag . html -Select industryName = new Select ("industry"); 
industryName .addOption ("a", "Advertising" ) ; 

i.addOption { "b" , "Consulting"); 

"Entertainment"); 



: new Labeledlnput ( "cstnm" , "Customer kT 



new Labeledlnput ( "psn" , "Position : " 
: new Labeledlnput ( "cnm" , "Company 



Indus tryN; 

industryName . addOpt, 

industryName -addOption ("d" 

industryName - addOption ( "e " 

industryName . addOption ( " f " 

industryName . addOption ( "g" 

indu s t ryName . addOp t i on ( " h " 
com. thinairapps . tag . html . Select salesContactName 



"Government " ) ; 
"Health Care") ; 
"Manufacturing" ) ; 



salesContactName . addOpti 

sales Contac t Name . addOpt i on ( " b " 

salesContac tName . addOpt i on ( " c " 

salesContactName . addOption ( "d" 

salesContac tName . addOpt i on ( " e " 

salesContactName .addOption ( "f " 

salesContactName -addOption ( "g" 

salesContactName -addOption ("' 



"Mikhail Bulgak< 
"Neil Diamond"); 
"Sam Donaldson") ; 
"Richard Feynman"); 
"Joe Frazier") ; 
"Arthur Rimbaud") ; 
"Leon Trotsky") ; 
"Michelle Yeoh") ; 



new Select ("sc" 



) ; 



com. thinairapps. tag. html. Labeledlnput ahName = new Labeledlnput (", 

com - thinairapps . tag . html - Select 

custstatusName .addOpt; 

custstatusName .addOpt; 

custstatusName .addOpt; 

custstatusName. addOption ("d' 

custstatusName - addOpt;' 

custstatusName-addOption ("f " , ' 

custstatusName. addOption ("g", ' 

custstatusName. addOption ("h", ' 
com. thinairapps . tag . html . SubmitButt 

//Add the inputs and selects to the Form 

//Hidden 

inputForm. addChild (new Input ( "hidden" , "action", "display")); 



"Account Number 1^ 



itstatusName = new Select ( "custstatus " ) ; 
Needs First Contact"); 
Needs Follow-Up"); 
Needs Credit Approval"); 
Needs to be Invoiced"); 
Credit Approved"); 
Invoice Sent" ) ; 
Credit Denied") ; 
Dead End" ) ; 

;on submit = new SubmitButton ( "Submit" , "Submit" ) ; 



inputForm 
inputForm 



input Form. c 
input Form. J 



inputForm. 
inputForm . 
inputForm. 



addChild (new Labeledlnput ( "cstnm" , "Customer Name:") 

addChild (new com . thinairapps . tag . html . Break ()) ; 

-d (new Labeledlnput ( "psn" , "Position :")) ; 

.d (new com . thinairapps . tag . html .Break ()) ; 

1. addChild (new Labeledlnput ( "cnm" , "Company Name:")); 

1. addChild (new com . thinairapps . tag . html . Break ()) ; 

addChild (new Text (" Industry : &nbsp ;")) ; 

addChild (industryName) ; 

addChild (new com. thinairapps . tag . html . Break ()) ; 
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nputForm. addChild (new TextC'Sales Contact ;   ")) ; 

inputForm.addChild (salesContactName) ; 

inputForm. addChild (new com. thinairapps . tag .html . Break ()) ; 

iputForm. addChild (new Labeledlnput ( "an" , "Account Number: 

inputForm.addChild (new com. thinairapps . tag . html . Break ()) ; 

, nputForm. addChild (new Text ( "Customer Status :   ")) ; 

inputForm.addChild (custstatusName) ; 

'.nputForm. addChild (new com. thinairapps . tag . html . Break ()) ; 

.nputForm. addChild (new com. thinairapps . tag . html .Break ()) ; 

.nputForm. addChild (submit) ; 

.nputForm. addChild (new com . thinairapps . tag . html . Break ()) ; 



//Set the href with the values from the user 

//href = CRMConnector .path + "?action=display&:amp;cstnm=$Gstnm&psn=$psn&cnm=$i(? 

cnm&amp ; Indus try=$ Indus try&amp ; spm=$spm&amp ; sc=$salesContact&:amp ; an=$an&amp ; \^ 

custstatus=$custstatus&amp ; rnd= " +Math . random { ) ; 
//Add the Form to the body 
body. addChild (inputForm) ; 

body. addChild (new com. thinairapps . tag . html .Break () ) ; 
//Add the body to the document 
doc . setBody (body) ; 

String resultString = doc . render () ; 
return resultString; 



/** 

* Display to the user the available ways that they can view the data in the folder. 

* renderOptionMenu ( ) renders an option screen, users select one of those options and 

* Handle 0 checks the URL and then calls this method if users wanted to see all the 

* available to them 

* ©return the rendered HTML deck 
*/ 

static String renderAvailableViews () 
{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com.thinairapps.tag.html .Head head = new com . thinairapps .tag .html .Head () ; 

if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector .g_DEVICE ^ 

instanceof OmniSkyDevice) 

{ 

Meta meta = new Meta("name", "PalmComputingPlatf orm" , "true"),- 

head. addChild (meta) ; 

} 

com. thinairapps . tag .html .Bold bold = new com . thinairapps . tag . html . Bold (" Sample CRM !/■ 

Connector" ) ; 
head. addChild (bold) ; 
doc . setHead (head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag .html . Paragraph para = new com . thinairapps . tag . html . Paragraph () ; 
para .addChild (new com . thinairapps . tag . html . Text ( "Select a View:")); 

mBody . addChild (para) ; 

String href = CRMConnector . path + "?" + CRMConnector . ACTION_FIELD + "=" + ^ 

CRMConnector. VIEW_BY_STATUS + "&:amp;rnd=" + Math.randomO ; 
com.thinairapps.tag.html .Anchor anl = new com. thinairapps . tag . html .Anchor ( "Status" , 
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href, new com. thinairapps . tag . html . Text ( "View by Status")), - 
mBody.addChild{anl) ; 

mBody.addChild(new com. thinairapps . tag .html .Break () ) ; 

string href 2 = CRMConnector . path + + CRMConnector . ACTION_FIELD + "=" + ^ 

CRMConnector.VIEW_BY_INDUSTRY + "&rnd=" + Math . random ( ) ; 
com. thinairapps .tag. html .Anchor an2 = new com . thinairapps . tag . html . Anchor 

("Industry", href2, new com. thinairapps . tag . html . Text { "View by Industry")); 

mBody.addChild(an2) ; 

mBody.addChild(new com . thinairapps . tag -html . Break () ) ; 

String href 3 = CRMConnector . path + "?" + CRMConnector . ACTION_FIELD + " = " + i^r 
CRMConnector .VIEW_BY_SALESCONTACT + "&:amp;rnd=" + Math. random { ) ; 

com. thinairapps .tag. html .Anchor an3 = new com. thinairapps . tag . html .Anchor 

("Salescontact", hrefS, new com. thinairapps . tag . html .Text { "View by Sales 
Contact" ) ) ; 

mBody.addChild(an3) ; 

mBody .addChild (new com . thinairapps . tag . html . Break () ) ; 
doc . setBody (mBody) ; 

String resultString = doc . render () ; 
return resultString; 

} 



/** 

* This method renders the fields in a selected view. 

* TO DO -- display the number of items that have each field 

* TO DO -- turn this connector into a collection of widgets that 

* are more generic 

* (Sparam customltems All of the items in the folder 

* (Sparam view The view that the user wants to use on these items 

* ©return A rendered HTML deck 
*/ 

static String renderView (Storeltems customltems. String view) 
{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag . html . Head head = new com. thinairapps . tag . html . Head () ; 
if ( CRMConnector. g_DEVICE instanceof PalmVIIDevice j | CRMConnector .g_DEVICE 

instanceof OmniSkyDevice) 

{ 

Meta meta = new Meta("name", "PalmComputingPlatform" , "true"); 

head.addChild(meta) ; 

} 

com. thinairapps. tag. html. Bold bold = new com. thinairapps . tag . html .Bold ( "Sample CRM 

Connector" ) ; 
head. addChild (bold) ; 
doc . setHead (head) ; 

Body mBody = new Body ( ) ; 

com. thinairapps . tag .html . Paragraph p = new com. thinairapps . tag . html . Paragraph () ; 

if (view. equals (CRMConnector .VI EW_BY_STATUS) ) 
{ 

p . addChild (new Text ( "View By Customer Status:")); 
p. addChild (new Break () ) ; 

//add the Paragraph 
mBody. addChild (p) ; 

com. thinairapps . tag .html . Paragraph p2 = new Paragraph (Paragraph. ALIGN_LEFT) ; 



/** 

//Links to the possible actions 
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String nfcHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + "=" 

CRMConnector .STS_NEEDS_FIRST_CONTACT + "&rnd=" + Math . random () ; 
String nfHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD + "=" 

CRMConnector. STS_NEEDS_FOLLOWUP + " Samp ; rnd= " + Math. random () ; 
String ncaHref = CRMConnector . path+ "?" + CRMConnector .ACTION_FIELD + "=" 

CRMConnector. STS_NEEDS_CREDIT_APPROVAL + " &ainp ; rnd= " + Math . random () ; 
String ntbiHref = CRMConnector . path+ "?" + CRMConnector .ACTION_FIELD + "= 

CRMConnector. STS_NEEDS_TO_BE_INVOICED + "&rnd=" + Math . random () ; 
String caHref = CRMConnector . path+ "?" + CRMConnector .ACTION_FIELD + "=" 

CRMConnector . STS_CREDIT_APPROVED + "&rnd=" + Math . random ( ) ; 
String isHref = CRMConnector . path+ "?" + CRMConnector .ACTION_FIELD + ■'=" 

CRMConnector .STS_INVOICE_SENT + " Samp ; rnd= " + Math . random () ; 
String cdHref = CRMConnector . path+ "?" + CRMConnector .ACTION_FIELD + "=" 

CRMConnector .STS_CREDIT_DENIED + " Samp ; rnd= " + Math. random () ; 
String deHref = CRMConnector . path+ "?" + CRMConnector .ACTION_FIELD + "=" 

CRMConnector . STS_DEAD_END + "&rnd=" + Math . random ( ) ,- 



com . thinairapps . tag .html . Anchor nfcAnchor = new com. thinairapps .tag. html .Anchor 
( "FirstContact " , nfcHref, new com . thinairapps . tag . html .Text ( "Needs First 
Contact") ) ; 

com.thinairapps.tag.html .Anchor nf Anchor = new com. thinairapps . tag . html .Anchor 
("FollowUp", nfHref, new com. thinairapps . tag .html . TexJ; ( "Needs Follow-Up" ) ) ; 
com. thinairapps -tag -html .Anchor ncaAnchor = new com. thinairapps . tag . html .Anchor 
_ ( "CreditApproval " , ncaHref, new com. thinairapps . tag . html . Text ( "Needs Credit 

Approval " ) ) ; 

com. thinairapps . tag .html .Anchor ntbiAnchor = new com. thinairapps . tag .html .Anchor 
("Invoice", ntbiHref, new com. thinairapps . tag . html .Text ( "Needs to be 
Invoiced" ) ) ,- 

com. thinairapps. tag. html. Anchor caAnchor = new com. thinairapps . tag .html .Anchor 
( "Credit Approved " , caHref, new com. thinairapps -tag -html . Text ( "Credit 
Approved" ) ) ; 

com. thinairapps . tag. html .Anchor isAnchor = new com. thinairapps. tag. html. Anchor 
{" Invoices ent " , isHref , new com . thinairapps . tag . html . Text (" Invoice Sent")); 

com. thinairapps. tag. html .Anchor cdAnchor = new com. thinairapps. tag. html. Anchor 

( "CreditDenied" , cdHref, new com. thinairapps . tag. html . Text ( "Credit Denied")); 

com.thinairapps.tag.html .Anchor deAnchor = new com. thinairapps . tag. html .Anchor 
{"DeadEnd", deHref, new com. thinairapps . tag . html . Text ( "Dead End")); 

mBody . addChild (nfcAnchor) ; 

mBody . addChild (new com. thinairapps . tag . html . Break ( ) 
mBody. addChild (nf Anchor) ; 
1==^ mBody. addChild (new com. thinairapps . tag . html .Break ( ) 

mBody .addChild (ncaAnchor) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) 
mBody . addChild (ntbiAnchor) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) 
mBody. addChild (caAnchor) ; 

mBody . addChild {new com. thinairapps . tag . html .Break ( ) 
mBody. addChild (isAnchor) ; 

mBody .addChild (new com. thinairapps . tag .html . Break ( ) 
mBody. addChild (cdAnchor) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) 
mBody . addChild (deAnchor) ; 

mBody . addChild (new com. thinairapps . tag . html . Break ( ) 
*/ 

/////////////////////////////////////////////////////////////////// 
//Add links to all the possible actions 
string [] statusHREFNames 

= { "nfcHref " , "nfHref " , "ncaHref " , "ntbiHref " , "caHref " , 



.sHref " 



"CdHref" 



"deHri 



String [] statusURLParams = {CRMConnector . STS_NEEDS_FIRST_CONTACT, CRMConnector . 

STS_NEEDS_FOLLOWUP , CRMConnector . STS_NEEDS_CREDIT_APPROVAL , CRMConnector . 

STS_NEEDS_TO_BE_INVOICED , CRMConnector . STS_CREDIT_APPROVED , CRMConnector . 

STS_INVOICE_SENT , CRMConnector . STS_CREDIT_DENIED , CRMConnector . STS_DEAD_END } ; 
String [] statusAnchorValues 

= { "FirstContact" , "FollowUp" , "CreditApproval" , "Invoice" , "Credit Approved" , "I: 

oiceSent" , "CreditDenied" , "DeadEnd" } ; 
String [] statusAnchorDisplayText = {"Needs First Contact" , "Needs 
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Follow-Up" , "Needs Credit Approval" , "Needs to be Invoiced" , "Credit 
Approved" Invoice Sent" , "Credit Denied" , "Dead End"}; 
com. thinairapps.tag.html. Anchor [] statusAnchorNaraes = {new com. thinairapps . tag . ^ 
html .Anchor ("nfcAnchor") , new com. thinairapps . tag . html .Anchor ( "nf Anchor" ) ,new ^ 
com. thinairapps. tag. html. Anchor ("ncaAnchor") , new com.thinairapps.tag.html. ^ 
Anchor ( "ntbiAnchor" ) ,new com. thinairapps . tag . html .Anchor ( "caAnchor" ) ,new com. 
thinairapps. tag. html. Anchor("isAnchor") ,new com. thinairapps . tag. html .Anchor Z 
( "cdAnchor" ) ,new com. thinairapps . tag .html .Anchor ( "deAnchor " ) } ; 



for (i = 0; i < 8; i++) 
{ 

statusHREFNames [i] = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD \^ 
+ " = " + statusURLParams [i] + "&:amp;rnd=" + Math, random () ; 

statusAnchorNames [i] = new com. thinairapps . tag .html .Anchor (statusAnchorValuesi^ 
[i] , StatusHREFNames [i] , new com. thinairapps .tag. html .Text \£ 
(statusAnchorDisplayText [i] ) ) ; 

mBody.addChild{ StatusAnchorNames [i] ) ; 

mBody.addChild(new com. thinairapps . tag. html . Break ( ) ) ,- 

} 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 11 1 1 1 1 1 / 
//add the body 
doG.setBody(mBody) ; 

} 

else if (view. equals (CRMConnector . VIEW_BY_INDUSTRY) ) 
{ 

^=-' p.addChild (new Text ("View By Industry Name:")); 

ig p.addChild (new Break ()) ; 

//add the Paragraph 
mBody .addChild (p) ; 

com. thinairapps . tag . html . Paragraph p2 = new Paragraph (Paragraph. ALIGN_LEFT) ; 
/** 

= //Links to .the possible actions 

string advHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIEDD + + ^ 

CRMConnector. I_ADVERTISING + " Stamp ;rnd=" + Math . random () ; 
string conHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD + "=" + ^ 

CRMConnector . I_CONSULTING + "&rnd=" + Math . random () ; 
String entHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD + "=" + \^ 

CRMConnector . I_ENTERTAINMENT + "&md=" + Math . random () ; 
String finHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD + "=" + 

CRMConnector. I_FINANCE + "&rnd=" + Math . random () ; 
String govHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD + "=" + 

CRMConnector . I_GOVERNMENT + " &amp ; rnd= " + Math . random ( ) ; 
String heaHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD + "=" + ^ 

CRMConnector . I_HEALTHCARE + "&rnd=" + Math . random () ; 
String manHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD + "=" + ^ 

CRMConnector . I_MANUFACTURING + "&rnd=" + Math . random () ; 
string retHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + "=" + 

CRMConnector . I_RETAIL + " &amp ; rnd= " + Math . random ( ) ; 

com. thinairapps . tag .html .Anchor advAnchor = new com. thinairapps . tag . html .Anchor 

("Advertising", advHref, new com . thinairapps . tag . html .Text ( "Advertising" )) ; 
com. thinairapps . tag . html .Anchor conAnchor = new com. thinairapps . tag . html .Anchor 

("Consulting", conHref, new com. thinairapps . tag .html . Text ( "Consulting ")) ; 
com . thinairapps . tag .html .Anchor entAnchor = new com. thinairapps . tag . html .Anchor ^ 

("Entertainment", entHref, new com . thinairapps . tag . html . Text ^ 

("Entertainment") ) ; 

com. thinairapps . tag .html .Anchor finAnchor = new com. thinairapps . tag . html .Anchor ^ 

("Finance", finHref, new com. thinairapps . tag . html .Text ( "Finance ")) ; 
com. thinairapps . tag . html . Anchor govAnchor = new com . thinairapps . tag . html .Anchor i^r 

("Government", govHref, new com. thinairapps . tag .html . Text ( "Government ")) ; 
com. thinairapps . tag. html .Anchor heaAnchor = new com. thinairapps . tag . html .Anchor kT 

("Healthcare", heaHref, new com . thinairapps . tag . html . Text ( "Healthcare ")) ; 
com. thinairapps . tag . html .Anchor manAnchor = new com. thinairapps . tag . html .Anchor 

("Manufacturing", manHref, new com. thinairapps . tag . html .Text ^ 

( "Manufacturing" ) ) ; 
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com. thinairapps . tag .html .Anchor retAnchor = new com. thinairapps . tag .html .Anchor 
("Retail", retHref , new com. thinairapps . tag . html .Text ( "Retail" )) ; 

mBody.addChild(advAnchor) ; 
mBody.addChild(new com.thinai 
mBody.addChild(conAnchor) ; 
mBody.addChild(new com.thinai 
mBody.addChild{entAnchor) ; 
mBody.addChildCnew com.thinai 
mBody. addChild (f inAnchor) ; 
mBody . addChild (new com.thinai 
mBody. addChild (govAnchor) ; 
mBody . addChild (new com.thinai 
mBody. addChild (heaAnchor) ; 
mBody. addChild (new com.thinai 
mBody . addChild (manAnchor) ; 
mBody . addChild (new com.thinai 
mBody . addChild (retAnchor) ; 
mBody . addChild (new com.thinai 
*/ 

/////////////////////////////////////////////////////////////////// 
//Add links to all the possible actions 

String [] Indus tryHREFNames ^ i^r 

= { "advHref " , "conHref " , "entHref " , "f inHref " , "govHref " , "heaHref " , "manHref " , "reti^' 
Href"}; 

String [] industryllRLParams = {CRMConnector . I_ADVERTigiNG, CRMConnector . l^• 
I_CONSULTING, CRMConnector . I_ENTERTAINMENT, CRMConnector . I_FINANCE , CRMConnector i^- 
. I_GOVERNMENT , CRMConnector . r_HEAIjTHCARE , CRMConnector . I_MANUFACTURING , 
CRMConnector . I_RETAIL} ; 

string [] industryAnchorValues \i 
= {"Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Healthcki' 
are" , "Manufacturing" , "Retail" } ; 

String [] IndustryAnchorDisplayText 

= { "Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Healthci^ 
are" , "Manufacturing" , "Retail" } ; 

com.thinairapps.tag.html .Anchor [] industryAnchorNames = {new com. thinairapps . tag uf 
Q -html .Anchor ( "advAnchor" ), new com. thinairapps . tag . html .Anchor ( "conAnchor" ) , wT 

new com. thinairapps . tag .html .Anchor ( "entAnchor" ), new com. thinairapps . tag . html 
.Anchor("f inHref ") ,new com. thinairapps . tag .html .Anchor ( "govAnchor" ), new com. 
thinairapps . tag .html .Anchor ( "heaAnchor" ) ,new com. thinairapps . tag .html .Anchor 
("manAnchor") ,new com . thinairapps .tag. html .Anchor ( "retAnchor" ) } ; 

for (i = 0; i < 8; i++) 
{ 

industryHREFNames [i] = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD ^ 
+ "=" + industryURLParams [i] + "&rnd=" + Math . random () ; 

industryAnchorNames [i] = new com. thinairapps . tag . html .Anchor i^" 
(industryAnchorValues [i] , industryHREFNames [i] , new com. thinairapps . tag . 
html. Text (IndustryAnchorDisplayText [i] ) ) ; 

mBody. addChild(industryAnchorNames [i] ) ; 

mBody . addChild (new com . thinairapps . tag . html . Break ( ) ) ; 

} 

/////////////////////////////////////////////////////////////////// 
//add the body 
doc . setBody (mBody) ; 

} 

else if (view. equals (CRMConnector .VIEW_BY_SALESCONTACT) ) 
{ 

p. addChild (new Text ( "View By Sales Contact:")); 
p. addChild (new Break ()) ; 

//add the Paragraph 
mBody . addChild (p) ; 

com.thinairapps.tag.html .Paragraph p2 = new Paragraph (Paragraph . ALIGN_LEFT) ; 



//Links to the possible actions 



C : \TASS\WirelessSDK\ . . \Connectors\CRM\src\CRMHTMLRenderer . java 



12 



String arHref = CRMConnector . path+ "?" + CRMConnector .ACTION_FIELD + " 

CRMConnector . SC_ARTHUR_RIMBAUD + "&rnd=" + Math . random () ; 
String jfHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD + " 

CRMConnector. SC_JOE_FRAZIER + " Siamp ; rnd= " + Math . random () ; 
String ItHref = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELD + " 

CRMConnector . SC_LEON_TROTSKY + " S=amp ; rnd= " + Math . random {) ; 
String myHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + " 

CRMConnector. SC_MICHELLE_YEOH + " Samp ; rnd= " + Math . random () ; 
String mbHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + " 

CRMConnector . SC_MIKHAIL_BULGAKOV + " Samp ; rnd= " + Math . random ( ) ; 
String ndHref = CRMConnector . path+ "?" + CRMConnector .ACTION_FIELD + " 

CRMConnector. SC_NEIL_DIAMOND + "6£amp;rnd=" + Math . random () ; 
String rfHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + " 

CRMConnector .SC_RICHARD_FEYNMAN + "&:amp;rnd=" + Math . random () ; 
String sdHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + " 

CRMConnector .SC_SAM_DONAIjDSON + "&amp,-rnd=" + Math . random () ; 

com. thinairapps.tag.html. Anchor arAnchor = new com . thinairapps . tag . html . Anchor kT 

("Rimbaud", arHref, new com. thinairapps . tag . html . Text ( "Arthur Rimbaud") ); 
com. thinairapps. tag. html. Anchor jf Anchor = new com. thinairapps. tag. html. Anchor ^ 

("Frazier", jfHref, new com. thinairapps . tag .html . Text ( "Joe Frazier")); 
com.thinairapps.tag.html .Anchor ItAnchor = new com . thinairapps . tag . html . Anchor «r 

("Trotsky", ItHref, new com. thinairapps . tag . html . Texti "Leon Trotsky")); 
com. thinairapps. tag. html .Anchor my Anchor = new com.thinairapps.tag.html .Anchor 

("Yeoh", myHref, new com. thinairapps . tag . html .Text ( "Michelle Yeoh")); 
com. thinairapps . tag .html .Anchor mbAnchor = new com. thinairapps . tag .html .Anchor \^ 

("Bulgakov", mbHref, new com. thinairapps . tag . html . Text ( "Mikhail Bulgakov")}; 
com. thinairapps . tag .html .Anchor ndAnchor = new com. thinairapps . tag .html .Anchor 

("Diamond", ndHref, new com. thinairapps . tag .html .Text ( "Neil Diamond")); 
com. thinairapps . tag .html .Anchor rfAnchor = new com . thinairapps . tag . html .Anchor 

("Feynman", rfHref, new com. thinairapps . tag -html . Text ( "Richard Feynman")}; 
com. thinairapps . tag .html .Anchor sdAnchor = new com. thinairapps . tag -html .Anchor 

("Donaldson", sdHref, new com. thinairapps . tag . html . Text ( "Sam Donaldson")); 

mBody.addChild (arAnchor) ; 

mBody.addChild(new com . thinairapps . tag . html .Break (} ) ; 
mBody.addChild(jf Anchor) ; 

mBody.addChild (new com. thinairapps . tag .html .EreakO ) ; 
mBody.addChild (ItAnchor) ; 
J mBody.addChild (new com. thinairapps . tag . html .Break ()) ; 

mBody .addChild(myAnchor) ; 

mBody.addChild (new com. thinairapps . tag . html .Break () ) ; 
mBody .addChi Id (mbAnchor) ; 

mBody .addChild (new com. thinairapps . tag . html .Break () ) ; 
mBody.addChild (ndAnchor) ; 

mBody .addChild (new com. thinairapps . tag . html .Break () ) ; 
mBody .addChild (rfAnchor) ; 

mBody. addChild (new com. thinairapps . tag . html .Break () ) ; 
mBody. addChild{sdAnchor) ; 

mBody .addChild (new com. thinairapps . tag . html .Break () ) ; 
/////////////////////////////////////////////////////////////////// 
/** 

//Add links to all the possible actions 

String [] salescontactHREFNames i^' 
= { "arHref" , "jfHref" , "ItHref" , "myHref" , "mbHref" , "ndHref", "rfHref" , "sdHref"} ; 

String [] salescontactURLParams = {CRMConnector . SC_ARTHUR_RIMBAUD, CRMConnector . 

SC_JOE_FRAZIER, CRMConnector . SC_LEON_TROTSKY, CRMConnector . SC_MICHELLE_YEOH, ifT 
CRMConnector. SC_MIKHAIL_BULGAKOV, CRMConnector .SC_NEIL_DIAMOND, CRMConnector . 
SC_RICHARD_FEYNMAN, CRMConnector . SC_SAM_DONALDSON} ; 

String [] salescontactAnchorValues ^ 
= { "Rimbaud" , "Frazier" , "Trotsky" , "Yeoh" , "Bulgakov" , "Diamond" , "Feynman" , "Donal 

String [] salescontact AnchorDisplayText = {"Arthur Rimbaud" , "Joe Frazier" , "Leon \^ 
Trotsky" , "Michelle Yeoh" , "Mikhail Bulgakov" , "Neil Diamond" , "Richard ^ 
Feynman" , "Sam Donaldson" } ; 

com. thinairapps . tag .html -Anchor [] salescontactAnchorNames = {new com. thinairapps 
. tag. html . Anchor (" arAnchor " ) , new com. thinairapps . tag .html -Anchor ( " j f Anchor" ) , ^ 
new com. thinairapps . tag . html .Anchor {" ItAnchor" ) ,new com. thinairapps . tag . html - 
Anchor ( "my Anchor" ), new com. thinairapps . tag . html .Anchor ( "mbAnchor" ), new com. 
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thinairapps . tag .html -Anchor ( "ndAnchor" ) ,new com. thinairapps . tag .html .Anchor kT 
("rfAnchor") ,new com. thinairapps . tag .html .Anchor ( "sdAnchor" ) }; 

int i; 

for (i = 0; i < 8; i++) 
{ 

salescontactHREFNames [i] = CRMConnector .path+ "?" + CRMConnector .ACTION_FIELDkr 
+ "=" + salescontactURLParams [i] + "&rnd=" + Math. random () ; 

salescontactAnchorNames [i] = new com. thinairapps . tag . html .Anchor \i 
(salescontactAnchorValues [i] , salescontactHREFNames [i] ,new com. thinairapps 
. tag .html . Text (salescontactAnchorDisplayText [i] ) ) ; 

mBody.addChildlsalescontactAnchorNames [1] ) ; 

mBody.addChild (new com. thinairapps . tag .html . Break () ) ,- 

} 

*/ 

iiiiiiiiiiiii/iiiiiiiiiiiiiiiiiiii/i/fmnmmiii/miiiiiiniii 

//add the body 
doc.setBody(mBody) ; 

} 

String resultString = doc . render () ; 
return resultString; 

} 



*A user selects a field value by which to sort the contents of the folder and 

* then this method is called to display all the items that have that value 

* ©param fieldValue The value of the field by which the user wants to sort the folder 

* @param access A handle to ConnectorAccess and the ThinAir Server services 

* @param sessionid An identifier of the user's already established session 

* ©return A collection of Storeltems that satisfy the criteria of the user 
*/ 

static String viewByField (String fieldValue, ConnectorAccess access. String sessionid) 
throws Exception 

{ 

HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag. html .Head head = new com . thinairapps . tag .html . Head () ; 

if (CRMConnector .g_DEVICE instanceof PalmVI IDevice | | CRMConnector .g_DEVICE yr 

instanceof OmniSkyDevice) 

{ 

Meta meta = new MetaC'name", "PalmComputingPlatf orm" , "true"); 

head.addChild(meta) ; 

} 

com. thinairapps. tag. html. Bold bold = new com. thinairapps . tag .html . Bold ( "Sample CRM 

Connector" ) ; 
head. addChild (bold) ; 
doc . setHead (head) ; 

Body mBody = new Body { ) ; 

com. thinairapps . tag .html . Paragraph p = new Paragraph (Paragraph. ALIGN_LEFT) ; 

p. addChild (new Text ("Matching Items:")); 
p . addChild (new Break () ) ; 

//add the Paragraph 
mBody. addChild (p) ; 

com. thinairapps . tag .html . Paragraph p2 = new Paragraph (Paragraph .ALIGN_LEFT) ; 

//The cache for this session 
Hashtable cache = null; 

//The Vector that will store the items that have fields that match the incoming fieldir? 
parameter 

Vector itemswMatchingf ields = new Vector(15); 
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//Get the cache for this session 

cache = access . getSessionCache ( sessionld) ; 

//Retieve the Store Items that we've already placed into the cache 
Storeltems customltems = ( (Storel terns) cache .get ( "storeitems" )) ; 

//we get an Enumeration of the items.. . 

Enumeration sortedltemEnum = { ( (Vector) customltems) . elements {) ) ; 
boolean didAnyltemsMatch = false; 

//Go through the items, and identify those that have the field that 

//has been passed in as the search parameter. 

int itemlterated = 0 ; 

String elementNumber = "elemnum"; 

String href = " " ; 

com. thinairapps . tag. html .Anchor itemAnchor = new com. thinairapps . tag .html . Anchor ("" , ^ 
href ) ; 

while ( sortedltemEnum. hasMoreElements {) ) 
{ 

String fieldText = null; 
String companyName = null; 

Customltem custltem = (Customltem) sortedltemEnum. nextElement () ; 
//Get the fields of the item 

Data customFields = custltem. getCustomFieldData () ; 

//Get an enumeration of the fields 

Enumeration fieldEnum = customFields .getFields {) ; 

//If the search parameter matches a field on the item, then we return a link to ^ 
the 

//item with the item's company name displayed. 

boolean hasField = false; 

while (fieldEnum. hasMoreElements {) ) 

{ 

Field thisField = (Field) fieldEnum. nextElement () ; 

//Get the Item's Company Name field. We need it for displaying a link to thei^ 
item. 

if (thisField .getName (). equals ("CompanyName")) 
{ 

companyName = thisField . getString () ; 

if (hasField == true) 

{ 

//Create the link; to the Item, with the Company Name field rendered 
href = CRMConnector .path+ "?" + CRMConnector . ACTION_FIELD + "=" + 

CRMConnector.VIEW_BY_FIELD_ACTION + " & elemnum= " + 

itemlterated + "&rnd=" + Math. random () ; 

//initialize the anchor 

itemAnchor = new Anchor ("CompanyName" , href , new com. thinairapps . tag . 

html . Text ( companyName ) ) ; 
//Add the Break 

mBody . addChild (new com. thinairapps . tag . html .Break () ) ; 

/ /Add the anchor 

mBody .addChild (itemAnchor) ; 

didAnyltemsMatch = true; 

//Add to our Vector of items with matching fields 
itemswMatchingf ields .addElement (custltem) ; 
companyName = null; 
hasField = false; 
break; 

ilse 
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//We will display links only to those items that match the criteria that the 
//user is asking for. 

else if <thisField.getString() .equals(fieldValue) ) 

{ 

hasField = true; 

if ( ! ( companyName == null)) 

{ 

//Create the link to the Item, with the Company Name field rendered 
href = CRMConnector.path+ "?" + CRMConnector . ACTION_FIELD + "=" + 

CRMConnector.VIEW_BY_FIELD_ACTION + "&elemnum=" + 

itemlterated + "&rnd=" + Math. random {) ; 

//Initialize the anchor 

itemAnchor = new Anchor ("CompanyName" , href , new com. thinairapps . tag . 

html -Text (companyName) ) ; 
//Add the Break 

raBody .addChild(new com. thinairapps. tag. html. BreakO ) ; 
//Add the anchor 
mBody.addChild( itemAnchor) ; 

didAnyltemsMatch = true; 

//Add to our Vector of items with matching fields 
itemswMatchingf ields .addElement (custltem) ; 
companyName = null; 
hasField = false; 
break; 



} // end while 
itemlterated++ ; 



//If no items matched the criteria, render this fact 

if (didAnyltemsMatch == false) 

{ 

mBody.addChild{new com. thinairapps . tag .html . Break () ) ; 
mBody.addChild(new Text ("No Items to Display")); 
mBody.addChild(new com. thinairapps . tag .html . Break ( ) ) ; 
mBody.addChild(new com. thinairapps. tag. html .Break () ) ; 

} 

else if ('(didAnyltemsMatch == false)) 
{ 

mBody.addChild(new com. thinairapps . tag .html . Break () ) ; 

} 

//link home. 

String startHref = CRMConnector .path+ "?rnd="+Math. random () ; 
//Initialize the anchor 

com. thinairapps . tag .html .Anchor startAnchor = new Anchor ( "Start ", startHref , n 

thinairapps . tag .html . Text ( "Start again ...")); 
//Add the Break 

mBody.addChild(new com. thinairapps . tag . html . Break ( ) ) ; 
//Add the anchor 
mBody.addChild( start Anchor) ; 

/ / add the body 

doc . setBody (mBody) ; 



return doc. render () ; 

} 
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* Renders an input form with the values preset 

* Pass in the field values that the item had. 
*/ 

static String editltem (Customltem item. String messagelD) 
{ 

//Get the Data object that contains all our custom fields. 
Data customFields = item.getCustomFieldData ( ) ; 

//Get the fields that we're expecting 

String customerNameField = customFields . getPield (" CustomerName" ) .valueToString () ; 
String positionField = customFields . getField( "Position" ) .valueToString (> ; 
String companyNameField = customFields .getField ( "CompanyName "). valueToString () ; 
String industryField = customFields . getField( " Industry" ) .valueToString {) ; 
String itemCreatedField = customFields .getField ( "ItemCreated" ) .valueToString () ; 
String salesContactField = customFields .getField ( "Salescontact "). valueToString () ; 
String accountNumberField = customFields .getField ( "AccountNuraber" ). valueToString {) ; 
String customerStatusField = customFields . getField { "CustomerStatus "). valueToString () ; 



HTMLTagDocument doc = new HTMLTagDocument ( ) ; 

com. thinairapps . tag .html .Head head = new com. thinairapps . tag . html .Head () ; 

if (CRMConnector .g_DEVICE instanceof PalmVIIDevice | | CRMConnector .g_DEVICE instanceof 

OmniSkyDevice) 

{ 

Meta meta = new Meta("narae", "PalmComputingPlatf orm" , "true"); 

head.addChild(meta) ; 

} 

com.thinairapps.tag.html .Bold bold = new com. thinairapps . tag . html . Bold ( "Sample CRM 

Connector" ) ; 
head. addChild (bold) ,- 
doc. setHead (head) ; 



Body body = new Body ( ) ; 

com. thinairapps .tag. html . Paragraph para = new com. thinairapps . tag . html . Paragraph () ; 
body. addChild (para) ,- 

//Create the form 
String href = " /crm" ; 
com. thinairapps . tag .html . Form inputForm = new com. thinairapps . tag . html . Form ("Sample ^ 
Form",href , "POST") ; 



//Create the inputs and selects 

com.thinairapps.tag.html .Labeledlnput custName = new Labeledlnput ( "cstnm" , "input" , ^ 

customerNameField, "Customer Name: ") ; 
com.thinairapps.tag.html .Labeledlnput psnName = new Labeledlnput { "psn" ," input " , 

positionField, "Position: " ) ; 
com.thinairapps.tag.html .Labeledlnput compName = new Labeledlnput ( "cnm" input" , 

companyNameField, "Company Name : ") ; 



//Industry 

com. thinairapps . tag .html . Select industryName = new Select ("industry"); 
String [] industryURLParams = {"a", "b" , "c", "d" , " e " , " f " , "g" , "h" } ; 

String!] industries \i 
= ("Advertising", "Consulting", "Entertainment", "Finance", "Government", "Healthcare", "Mai^ 
nuf acturing" , "Retail " } ; 

com. thinairapps . tag. html .Option [] industryOptions=new Option [8]; 

int i ; 

for (i = 0; i < 8; i++) 
{ 

industryOptions [i] = new Option (industryURLParams [i] , industries [i] ) ; 
if (industryField. equals (industries [i] ) ) 
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industryOptions [i] . setSelected (true) ; 

else 
{ 

industryOptions [i] . setSelected (false) ; 

} 

industryName.addOption{ industryOptions [i] ) ; 



//Sales Contact 

com. thinairapps . tag -html . Select salesContactName = new Select ("sc"); 

String [] salesContactURLParams = {"a", "b", "c", "d", "e" , "f " , "g" , "h" } ; 

String [] salescontacts = {"Mikhail Bulgakov" , "Neil Diamond" , "Sam Donaldson" , "Richard 

Feynman" , " Joe Frazier" , "Arthur Rimbaud" , "Leon Trotsky" , "Michelle Yeoh" } ; 
com.thinairapps.tag.html .Option [] salesContactOptions = new Option[8]; 
int j ; 

for (j = 0; j < 8; j++) 
{ 

salesContactOptions [ j ] =new Option ( salesContactURLParams [ j ] , salescontacts [ j ] ) ; 
if (salesContactField. equals (salescontacts [j ]) ) 
salesContactOptions [j ] . setSelected (true) ; 

else 
{ 

salesContactOptions [j] . setSelected(false) ; 



salesContactName . addOption ( salesContactOptions [j ] ) ; 



//Customer Status 

com. thinairapps . tag. html -Select custstatusName = new Select ( "custstatus" ) ; 
String [] custstatusURLParams = {"a", "b" , "c", "d", "e" , "f " , "g" , "h" } ; 
String!] custstati = {"Needs First Contact" , "Needs Follow-Up" , "Needs Credit 

Approval" , "Needs to be Invoiced" , "Credit Approved" , "Invoice Sent" , "Credit 

Denied" , "Dead End" } ; 
com. thinairapps . tag .html .Option [] custstatusOptions = new Option[8]; 
int h; 

for (h = 0; h < 8; h++> 
{ 

custstatusOptions [h] =new Option (custstatusURLParams [h] , custstati [h] ) ; 
if (customerStatusField. equals (custstati [h] ) ) 
custstatusOptions [h] . setSelected (true) ; 

else 

custstatusOptions [h] . setSelected (false) ; 

} 

custstatusName. addOption {custstatusOptions [h] ) ; 

} 

new Labeledlnput ( "an" , "input" , 

com. thinairapps. tag. html. SubmitButton submit = new SubmitButton ( "Submit" , "Submit ") ; 

//Add the inputs and selects to the Form 

//Hidden 

inputForm. addChild (new Input ( "hidden" , "action", "update") ),- 
inputForm.addChild(new Input ( "hidden" , "MessagelD" , messagelD) ) ; 

inputForm. addChild (anName) ; 

inputForm. addChild (new com. thinairapps . tag . html . Break ()) ; 

inputForm. addChild (compName) ; 

inputForm. addChild (new com. thinairapps . tag . html .Break ()) ; 

inputForm. addChild (custName) ; 

inputForm. addChild (new com. thinairapps . tag . html .Break ()) ; 
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inputForm.addChild (new Text ( "Customer Status :   ")) ; 
inputForm.addChild (custstatusName) ; 

inputForm.addChild (new com. thinairapps . tag . html .Break ()) ; 

inputForm.addChild (new Text {" Industry : tnbsp ;">) ; 

inputForm.addChild (industryName) ; 

inputForm.addChild (new com. thinairapps . tag .html .Break ()) ; 

inputForm.addChild (psnName) ; 

inputForm.addChild (new com. thinairapps . tag . html .Break ()) ; 

inputForm.addChild (new TextC'Sales Contact : &nbsp ,-")) ; 

inputForm.addChild (salesContactNarae) ; 

inputForm.addChild {new com. thinairapps . tag . html .Break ()) ; 

inputForm.addChild (new com. thinairapps.tag.html. BreakO ) ; 

inputForm.addChild (submit) ; 

inputForm.addChild (new com. thinairapps . tag . html .Break ()) ; 

//Add the Form to the body 
body . addChild(inputForm) ; 

body . addChild(new com. thinairapps . tag . html .Break { ) ) ; 
//Add the body to the document 
doc . setBody (body) ; 

String resultString = doc . render () ; 

return resultString; 

} 
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/** ACCESS TO AND USE OF THIS SOFTWARE IS GOVERNED BY THE TERMS OF A SOFTWARE 

* LICENSE AGREEMENT BETWEEN THINAIRAPPS, INC. AND LICENSEE. ANY ACCESS OR 

* USE OF THE SOFTWARE IN VIOLATION OF THE SOFTWARE LICENSE AGREEMENT IS 

* STRICTLY PROHIBITED. 
*/ 

//core ThinAir Server API functionality 
import com. thinairapps .platform. * ; 
import com. thinairapps .platform. device . * ; 
import com. thinairapps .platform. connector . * ; 
import com . thinairapps .platform. exception. * ; 
import com. thinairapps . platform. provider . * ; 

//ThinAir Tag Libraries imports 
import com . thinairapps . tag .* ; 
import com . thinairapps . tag . wml . * ; 

// the groupware packages 

import thinairapps . groupware . api . * ; 

import thinairapps . groupware . api . actions . * ; 

import thinairapps -groupware .api .bounds . *; 

import thinairapps . groupware . api . exception . * ; 

//Standard Java imports 
import j ava .util . * ; 



/** 

* This utility class renders output as WML for a variety of devices 
*/ 

class CRMWMLRenderer 

:i 

/**This method renders a deck containing a welcome card 

* @return the rendered deck. 
*/ 

static String renderStartScreen ( ) 
{ 

//create the deck 

WMLTagDocuraent deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID 'cl' 
DisplayCard cardl = new DisplayCard ( "cl" ) ; 

//create a centered Paragraph 

Paragraph p = new Paragraph ( Paragraph. ALIGN_CENTER, Paragraph. MODE_NOWRAP) ; 
Bold b = new Bold (new Text ("Sample CRM Connector")); 
p.addChild(b) ; 
p.addChild (new Break ( ) ) ; 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph ( Paragraph . ALIGN_LEFT , Paragraph . MODE_N0WRAP ) ,- 
//Link 

String loginHref = CRMConnector . path + "?" + CRMConnector . ACTION_FIELD + "=" + 
CRMConnector .L0GIN_ACTION + "&rnd=" + Math . random () ; 

//Go task for the href 

Go loginGo = new Go (loginHref , true , Go . METH0D_GET) ; 
Anchor loginAnchor; 
//Anchor for the Go task 

if (CRMConnector .g DEVICE instanceof NokiaWAPDevice) 
{ 

p.addChild (new Break ( ) ) ; 
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p.addChild(new Break ( ) ) ; 

loginAnchor = new Anchor (loginGo, new Text ( "Login" )) ; 
p.addChild (loginAnchor) ; 

} 

else 
{ 

loginAnchor = new Anchor (loginGo, new Text { "Login" )) ; 
p.addChild (loginAnchor) ; 

} 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the card to the deck 
deck. addCard (cardl) ; 

String resultString = deck. render () ; 
return resultString; 



/** 

* This method renders a deck with a card that lets the user specify which action to take 

* ©return the rendered deck. 
*/ 

static String renderOptionMenu () 
{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID 'cl' 
DisplayCard cardl = new DisplayCard ( "cl " ) ; 

//create a centered Paragraph 

Paragraph p = new Paragraph ( Paragraph. ALIGN_CENTER, Paragraph. MODE_NOWRAP) ; 

Bold b = new Bold (new Text ( "Sample CRM Connector")); 
p.addChild(b) ; 
p.addChild (new Break ( ) ) ; 

/ /add the Paragraph to the card 
cardl .addParagraph (p) ; 

p = new Paragraph(Paragraph.ALIGN_LEFT, Paragraph. MODE_NOWRAP) 
// links to the two possible actions 

String createHref =CRMConnector .path+ "?" + CRMConnector . ACTION_FIELD + "=" + 

CRMConnector.CREATE_ACTlON + "&rnd=" + Math . random () ; 
String readHref = CRMConnector .path+ "?" + CRMConnector .ACTIOH_FIELD + "=" + ^ 

CRMConnector .VIEW_ACTION + " &amp ; rnd= " + Math . random () ,- 

// Go tasks for the two hrefs 

Go createGo = new Go (createHref, true, Go. METHOD_GET) ; 

Go readGo = new Go ( readHref , true , Go -METHOD_GET) ; 

Anchor createAnchor ; 
Anchor readAnchor; 

//Anchors for the two Go tasks 

if (CRMConnector .g_DEVICE instanceof NokiaWAPDevice) 
{ 

p.addChild (new Break () ) ; 

createAnchor = new Anchor (createGo, new Text ("Create a new item")); 
p.addChild (createAnchor) ; 
p.addChild (new Break () ) ; 

readAnchor = new Anchor (readGo, new Text("Select View")); 
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p.addChild(readAnchor) ; 
p.addChild(new Break {)) ; 

} 

else 
{ 

createAnchor = new Anchor (createGo, new Text ("Create a new item")); 
p.addChild{createAnchor) ,- 

readAnchor = new Anchor (readGo, new Text ("Select View")); 
p.addChild(readAnchor) ; 

} 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the card to the deck 
deck. addCard( cardl) ; 

String resultString = deck . render () ; 
return resultString; 



* Renders the fields of a single Customltem 

* @param item the Customltem whose fields we should render 

* Oreturn the rendered deck. 
*/ 

static String renderCustomltemFields (Customltem item, Connect or Access access, String \^ 
sessionid) throws Exception 

{ 

//Get the cache for this session 
Hashtable cache=null; 

cache = access .getSessionCache (sessionid) ; 

//Storing the item being viewed in the cache 
String itemViewed; 

itemViewed = cache .get (" ItemViewed" ). toString () ; 
//Get the messagelD 

String messagelD = ( (Storeltem) item) .getID ( ) ; 
//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
String url = null; 

//create the first card in the deck and give it the ID 'cl' 
DisplayCard card = new DisplayCard ( "cl" ) ; 

Paragraph p = new Paragraph (Paragraph .ALIGN_LEFT, Paragraph . MODE_NOWRAP) ; 
Bold b = new Bold(new Text("Item Fields:")); 
p.addChild(b) ; 
p.addChild(new Break () ) ; 
card. addParagraph (p) ; 

Paragraph p2 = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph .MODE_NOWRAP) ; 
// Now add the fields and their values: 

//first get the Data object that contains all the info about our custom fields. 
Data customFields = item.getCustomFieldData ( ) ; 

//Get an enumeration of the fields... 
Enumeration fieldEnum = customFields .getFields () ; 

// go through the fields, and add each one to the deck - we'll stop after 15, 
//to avoid any deck overflow problems 
int itemsDisplayed = 0 ; 
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while (f ieldEnum.hasMoreElements ( ) && itemsDisplayed < 15) 
{ 

String f ieldTextName = null; 
String f ieldTextValue = null; 

Field thisField = (Field) fieldEnum. nextElement () ; 

//We must check the type, because that determines how we retrieve the field 
if (thisField. getTypeO == Field. BOOLEAN_VAL) 

f ieldTextName = thisField. getName () ; 

f ieldTextValue = ": " + thisField . getBoolean () ; 

else if (thisField.getTypeO == Field.DOUBLE_VAL) 

f ieldTextName = thisField. getName () ; 

f ieldTextValue = ": " + thisField . getDouble () ; 

else if (thisField.getTypeO == Field . INT_VAL) 

f ieldTextName = thisField. getName () ; 

f ieldTextValue = ": " + thisField . getint () ; 

else if (thisField.getTypeO == Field. LONG_VAL) 

f ieldTextName = thi sField. getName () ; 

f ieldTextValue = ": " + thisField. getLong () ; 

else if (thisField.getTypeO == Field . STRING_VAL) 

f ieldTextName = thisField. getName 0 ; 

f ieldTextValue = ": " + thisField. getString () ; 

else if (thisField.getTypeO == Field. DATE_VAL) 

f ieldTextName = thisField. getName () ; 

f ieldTextValue = ": " + thisField. getDate () ; 



//Transform the field name to the what we want to display as the field name 

//We do this because we want the actual field names in Domino or Exchange to have 

//no spaces, but we want the display names to have spaces (i.e. ^ 

CustomerName- -Customer Name) 
String f ieldDisplay=null ; 

if (f ieldTextName .equals ("CustomerName")) 

f ieldDisplay="Customer Name"; 
else if (f ieldTextName . equals ("Position")) 

f ieldDisplay="Position" ; 
else if (f ieldTextName . equals ( " CompanyName " ) ) 

fieldDisplay=" Company Name"; 
else if (f ieldTextName . equals ("Industry")) 

f ieldDisplay="Industry" ; 
else if (f ieldTextName. equals ( " ItemCreated" ) ) 

f ieldDisplay="ltem Created"; 
else if (f ieldTextName . equals ("Salescontact")) 

fieldDisplay= "Sales Contact"; 
else if (f ieldTextName . equals ( " AccountNumber " ) ) 

fieldDisplay= "Account Number"; 
else if (f ieldTextName .equals ( " CustomerStatus " ) ) 

fieldDisplay= "Customer Status" ; 

//If there 'a a field on the form that we're not expecting, 
//don't display it 




} 

p2 .addChild(new Text (fieldDi splay) ) ; 
p2 .addChild(new Text (f ieldTextValue) ) ; 
p2 .addChild(new Break ( ) ) ; 
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itemsDisplayed++ ; 

} 

// link home. 

String href = CRMConnector . path+ "?rnd="+Math. random () ; 
//Edit link 

//One parameter must be dedicated to Insuring that we have the same item to edit 
String editHref = CRMConnector .path+"?"+ CRMConnector . ACTION_FIELD + "=" + 

CRMConnector. EDIT_ACTION + "&amp ; editPrm= " + itemViewed + "&amp ; rnd= "+Math . randomly' 

() ; 

Go go = new Go (href , true , Go.METHOD_GET) ; 

Go editGo = new Go(editHref, true, Go .METHOD_GET) ; 

Anchor anchor ; 
Anchor edit Anchor; 

if (CRMConnector .g_DEVlCE instanceof NokiaWAPDevice) 
{ 

p2 .addChild{new Break ()) ; 

anchor = new Anchor (go, new Text ("Start again...")); 
p2 . addChild (anchor) ; 

editAnchor = new Anchor (editGo, new Text ("Edit Item")); 
p2 .addChild (editAnchor) ; 

} 

else 
{ 

anchor = new Anchor (go, new Text ("Start again...")); 
p2 . addChild (anchor) ; 

editAnchor = new Anchor (editGo, new Text ("Edit Item")); 
p2 .addChild (editAnchor) ; 

} 

card.addParagraph(p2) ; 
deck.addCard (card) ; 
return deck . render ( ) ; 



/** This method renders a simple message, either an error or a success, 

* then links back to the main page 

* ©param message the message to be presented to the user 

* (Sreturn the rendered WML deck 
*/ 

static String renderMessage (String message) 
{ 

WMLTagDocument deck = new WMLTagDocument ( > ; 
Display-Card card = new DisplayCardO ; 
Paragraph p = new ParagraphO; 

p. addChild (new Text (message) ) ; 
p. addChild (new BreakO); 

//Link home 

String href = CRMConnector . path+ " ?rnd= " +Math . random () ; 
Go go = new Go (href , true , Go . METHOD_GET) ; 
Anchor anchor; 

if (CRMConnector .g_DEVICE instanceof NokiaWAPDevice) 
{ 

p. addChild (new BreakO ) ; 

anchor = new Anchor (go, new Text ("Start again...")); 
p . addChild (anchor) ; 

} 
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{ 

anchor = new Anchor (go, new Text ("Start again...")); 
p. addChild (anchor) ,- 

} 

card.addParagraph (p) ; 
deck. addCard (card) ; 

String resultString = deck . render () ; 
return resultString; 



/** 

* This method renders a deck with several cards including a welcome card and card for \t 

entering information 

* This method makes use of the ThinAir WML Tag Library for WML markup creation. For ^ 

more information 

* on use of the Tag Libraries, see the Tag Library documentation and the ThinAir Server \t 

Development Guide. 

* ©return the rendered deck. 
*/ 

static String renderlnputForm ( ) 
{ 

//Create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
//Create a MultiplelnputCard 

MultiplelnputCard cardl = new MultipIelnputCardC'gl") ; 

//Allow the user to type in information and set the input text to lowercase by 
default 

Labeledlnput custName = new Labeledlnput ( "cstnm" , "Customer Name:"); 
custName . setFormat ( " *m" ) ; 



Labeledlnput position = new Labeledlnput ( "psn" , "Position :") ; 
position . setFormat ( " *m" ) ; 

Labeledlnput compName = new Labeledlnput { "cnm" , "Company Name:"); 
compName . setFormat ( " *m" ) ; 

Labeledlnput [] inputsl = {custName, position, compName}; 
//A link to the second card 

cardl. buildCard("#g2", "OK" , inputsl , Go .METHOD_GET) ; 
deck. addCard (cardl) ; 



//Create a select card 

SelectlnputCard card2 = new SelectlnputCard ( "g2 " ) ; 

Option advertising = new Option ( "OK" , "a" , "Advertising" ) ; 
Option consulting = new Option ( "OK" , "b" , "Consulting" ) ; 
Option entertainment = new Option ( "OK" , "c" , "Entertainment" ) ; 
Option finance = new Option { "OK" , "d" , "Finance" ) ; 
Option government = new Option ( "OK" , "e" , "Government ") ; 
Option healthcare = new Option ( "OK" ," f ", "Health Care"); 
Option manufacturing = new Option ( "OK" , "g" , "Manufacturing" ) ; 
Option retail = new Option ( "OK" , "h" , "Retail ") ; 

//Make an array of all the options 

Option[] optionsl = {advertising, consulting, entertainment, finance, government, 
healthcare, manufacturing, retail}; 

//Build the card. 

card2 .buildCard{ "#g3 " , "Industry: " , "industry" , optionsl , Paragraph .ALIGN_LEFT, Paragraph . \^ 



C : \TASS\WirelessSDK\ ■ . \Connectors\CRM\src\CRMWMLRenderer . java 



7 



MODE_NOWRAP) ; 

//Add the SelectlnputCard 
deck.addCard(card2) 

//Create another Select card 

SelectlnputCard cards = new SelectlnputCard ("g3"); 
Option bulgakov = new Option ( "OK" , "a" , "Mikhail Bulgakov"); 
Option diamond = new Option { "OK" , "b" , "Neil Diamond"); 
Option donaldson = new Option ( "OK" , "c ", "Sam Donaldson"); 
Option feynman = new Option ( "OK" , "d" , "Richard Feynman"); 
Option frazier = new Option ( "OK" , "e" , "Joe Frazier"); 
Option rimbaud = new Option ( "OK" , "f" , "Arthur Rimbaud"); 
Option trotsky = new Option ( "OK" , "g" , "Leon Trotsky"); 
Option yeoh = new Option ( "OK" , "h" , "Michelle Yeoh"); 

Option [] optionsB = {bulgakov, diamond, donaldson, feynman, frazier, rimbaud, trotskyi^ 
, yeoh } ; 

//Build the card 

cards .buildCard ( "#g4 " , "Sales Contact : " , "salescontact" , optionsB , Paragraph .ALIGN_LEFT, 
Paragraph. MODE_NOWRAP) ; 

//Add the SelectlnputCard 
deck. addCard (cards) ; 

//Create a MultiplelnputCard 

MultiplelnputCard card3 = new MultiplelnputCard ( "g4 ") ; 

Labeledlnput actNumber = new Labeledlnput ( "an" , "Account Number:"); 
actNumber . setFormat ( "*m" ) ; 

Labeledlnput [] inputs2 = {actNumber}; 

card3.buildCard{"#g5","OK",inputs2, Go .METHOD_GET) ; 
deck. addCard (cards) ; 

//Create a select card 

SelectlnputCard card4 = new SelectlnputCard ( "gS ") ; 

Option needsf irstcontact = new Option ( "OK" , "a" , "Heeds First Contact"); 

Option needsfollowup = new Option ( "OK" , "b" , "Needs Follow-Up") ; 

Option needscreditapproval = new Option ( "OK" , "c" , "Needs Credit Approval"); 

Option needstobeinvoiced = new Option ( "OK" , "d" , "Needs to be Invoiced"); 

Option creditapproved = new Option ( "OK" , "e" , "Credit Approved"); 

Option invoicesent = new Option ( "OK" , "f ", "Invoice Sent"); 

Option creditdenied = new Option ( "OK" , "g" , "Credit Denied"); 

Option deadend = new Option ( "OK" , "h" , "Dead End"); 

//Make an array of all the options 

Option[] options2 = {needsf irstcontact , needsfollowup, needscreditapproval, \^ 
needstobeinvoiced, creditapproved, invoicesent, creditdenied, deadend}; 

/ /Set the URL params to the values in the WML variables 

//&, the escape sequence for ampersand, delimits name-value pairs. $ is used to 

dereference a WML variable. 
String href; 

href = CRMConnector .path + "?action=display&cstnm=$cstnm&psn=$psn&cnra=$ 

cnra& indus try=$ Indus t ry&amp ; spm=$spm&amp ; sc = $salesContact&an=$an& i^r 
custstatus=$custstatus& rnd= "+Math . random ( ) ; 



//Build the card. 

card4 .buildCard (href , "Customer Status : " , "cust status" , options2 , Paragraph. ALIGN_LEFT, \^ 
Paragraph. MODE_NOWRAP) ; 

//Add the SelectlnputCard 
deck.addCard(card4) ; 
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//Render the deck 
return deck . render ( ) ; 

) 



* Display to the user the available ways that they can view the data in the folder. 

* renderOptionMenu { ) renders an option screen, users select one of those options and 

* Handle {) checks the URL and then calls this method if users wanted to see all the 

views 

* available to them 

* ©return the rendered WML deck 
*/ 

static String renderAvailableViews () 
{ 

//create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID 'cl' 
DisplayCard cardl = new DisplayCard{ "cl") ; 

//create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph. ALIGN_CENTER, Paragraph. MODE_NOWRAP) ; 
Bold b = new Bold (new Text ("Select a View")) ; 
p.addChild(b) ; 
p.addChild(new BreakO); 

//add the Paragraph to the card 
cardl. addParagraph(p) ; 

p = new Paragraph ( Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 
// links to the possible actions 

String byStatusHref =CRMConnector .path+ "?" + CRMConnector . ACTION_FIELD + " = " + i^r 

CRMConnector . VIEW_BY_STATUS + " &amp ; rnd= " + Math . random () ; 
String bylndustryHref = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD + "=" + ^ 

CRMConnector. VIEW_BY_INDUSTRY + "&rnd=" + Math. random () ; 
String bySalesContactHref = CRMConnector. path+ "?" + CRMConnector .ACTION_FIELD ^ 

+ "=" + CRMConnector .VIEW_BY_SALESCONTACT + "&rnd=" + Math . random () ; 

// Go tasks for the hrefs 

Go byStatusGo = new Go (byStatusHref , true , Go .METHOD_GET) ; 

Go bylndustryGo = new Go (bylndustryHref , true , Go .METHOD_GET) ; 

Go bySalesContactGo = new Go (bySalesContactHref , true, Go .METHOD_GET) ; 

Anchor byStatusAnchor ; 
Anchor bylndustry Anchor; 
Anchor bySalesContactAnchor ; 

// Anchors for the two Go tasks 

if ( CRMConnector. g DEVICE instanceof NokiaWAPDevice) 
{ 

p.addChild(new BreakO ) ; 

byStatusAnchor = new Anchor (byStatusGo , new Text ( "View by Status")); 
p. addChild (byStatusAnchor) ; 

p.addChild(new BreakO ) ; 

bylndustryAnchor = new Anchor (bylndustryGo, new TextC'View by Industry Name")); 
p . addChild (bylndustryAnchor) ; 

p. addChild (new BreakO); 

bySalesContactAnchor = new Anchor (bySalesContactGo , new Text ("View by Sales Kf 

Contact" } ) ; 
p . addChild (bySalesContactAnchor) ; 

p . addChild (new Break () ) ; 

} 
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{ 

byStatusAnchor = new Anchor (byStatusGo, new Text ("View by Status")); 
p.addChild(byStatusAnchor) ; 

bylndustryAnchor = new Anchor (by Indus tryGo, new Text ( "View by Industry Name")); 
p.addChild{byIndustryAnchor) ; 

bySalesContactAnchor = new Anchor (bySalesContactGo, new Text ( "View by Sales 

Contact") ) ; 
p . addChild (bySalesContactAnchor) ; 

} 

//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the card to the deck 
deck. addCard (cardl) ; 

String resultString = deck. render () ; 
return resultString; 



/** 

* This method renders the fields in a selected view. 

* TO DO -- display the number of items that have each field 

* TO DO -- turn this connector into a collection of widgets that 

* @param customltems All of the items in the folder 

* csparam view The view that the user wants to use on these items 

* ©return A rendered WML deck 
*/ 

static String renderView (Storeltems customltems. String view) 
{ 

//create the deck 

VIMLTagDocument deck = new WMLTagDocument ( ) ; 

//create a card in the deck and give it the ID 'cl' 
DisplayCard cardl = new DisplayCard ( "cl " ) ; 

//create a centered Paragraph 

Paragraph p = new Paragraph (Paragraph. ALIGN_CENTER, Paragraph. MODE_NOWRAP) ; 

if (view. equals (CRMConnector . VIEW BY STATUS)) 
{ 

Bold b = new Bold (new Text ("View By Customer Status:")); 

p. addChild (b) ; 

p. addChild (new Break () ) ; 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 



p = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 

//Add links to all the possible actions 
String [] statusHREFNames 

= { "nf cHref " , "nfHref " , "ncaHref " , "ntbiHref " , "caHref " , "isHref " , "cdHref " , "deHref 

"}; 

string [] statusURLParams = (CRMConnector . STS_NEEDS_FIRST_CONTACT , CRMConnector . \^ 
STS_NEEDS_FOLLOWUP , CRMConnector . STS_NEEDS_CREDIT_APPROVAL , CRMConnector . 
STS_NEEDS_TO_BE_INVOICED , CRMConnector . STS_CREDIT_APPROVED , CRMConnector . ^ 
STS_I]SrvOICE_SENT , CRMConnector . STS_CREDIT_DENIED , CRMConnector . STS_DEAD_END } ; 

Go[] statusGoNames = {new Go (statusHREFNames [0] , true, Go. METHOD_GET) , new Go \^ 
(statusHREFNames [1] , true , Go .METHOD_GET) , new Go ( statusHREFNames [2] , true, Go. 
METHOD_GET) ,new Go ( StatusHREFNames [3 ], true , Go .METHOD_GET) , new Go 
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(statusHREFNames [4] , true,Go.METHOD_GET) , new Go (statusHREFNames [5] , true, Go. 
METHOD_GET) ,new Go { StatusHREFNames [6] , true , Go . METHOD_GET) , new Go 
(statusHREFNames [7] ,true,Go.METHOD_GET) } ; 

String [] statusAnchorDisplayText = {"Needs First Contact ", "Needs 

Follow-Up" , "Needs Credit Approval ", "Needs to be Invoiced" , "Credit ^ 
Approved" , "Invoice Sent ", "Credit Denied" , "Dead End" } ; 

com. thinairapps . tag -wml -Anchor [] statu sAnchorNames ={new com . thinairapps . tag . wml i^" 
. Anchor ( s tatusGoNames [0] , new Text ( StatusAnchorDisplayText [0] )), new com. kT 
thinairapps . tag .wml .Anchor ( statusGoNames [1] , new Text ( StatusAnchorDisplayText 
[1] ) ) ,new com. thinairapps .tag .wml .Anchor (statusGoNames [2] , new Text \e 
(StatusAnchorDisplayText [2] )), new com. thinairapps . tag .wml .Anchor ^ 
(statusGoNames [3] , new Text ( StatusAnchorDisplayText [3 ])), new com . thinairapps . i^- 
tag. wml .Anchor (statusGoNames [4] , new Text ( statusAnchorDisplayText [4 ] ) ) ,new comi^ 
.thinairapps .tag. wml .Anchor (statusGoNames [5] ,new Text ( StatusAnchorDisplayText 
[5] ) ) ,new com. thinairapps .tag .wml .Anchor (StatusGoNames [6] , new Text \t 
(StatusAnchorDisplayText [6] )), new com. thinairapps . tag .wml .Anchor 
(StatusGoNames [7] ,new Text (statusAnchorDisplayText [7] ) ) } ; 

for (i = 0; i < 8; i++) 
{ 

statusHREFNames [i] = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELD 

+ "=" + statusURLParams [i] + "&rnd=" + Math . random () ; 
StatusGoNames [i] = new Go(statusHREFNames [i] ,true,Go.METHOD_GET) ; 
if ( CRMConnector . g DEVICE instanceof NokiaWAPDevice) 
{ 

p.addChild{new Break ( ) ) ; 

statusAnchorNames [i] = new Anchor (statusGoNames [i] , new Text i^" 

(StatusAnchorDisplayText [i] ) ) ; 
p.addChild (StatusAnchorNames [i] ) ; 
p.addChild(new BreakO); 

} 

else 
{ 

StatusAnchorNames [i] = new Anchor (statusGoNames [i] , new Text ^ 

(statusAnchorDisplayText [i] ) ) ; 
p.addChild (statusAnchorNames [i] ) ; 

} 



//add the second Paragraph to the card 
cardl.addParagraph(p) ; 

/ /a<ld the card to the deck 
deck.addCard(cardl) ; 

} 

else if (view. equals (CRMConnector .VIEW BY INDUSTRY)) 
{ 

Bold b = new Bold (new Text ( "View By Industry Name : " ) ) ; 
p.addChild(b) ; 
p.addChild (new BreakO); 

//add the Paragraph to the card 
cardl . addParagraph (p) ; 

p = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 
//Add links to all the possible actions 

String [] industryHREFNames ^ 
= { "advHref " , "conHref " , "entHref " , "f inHref " , "govHref " , "heaHref " , "manHref " , "ret if 
Href"} ; 

String [] industryURLParams = {CRMConnector. I^ADVERTISING, CRMConnector . vf 
I_CONSULTING, CRMConnector . I_ENTERTAINMENT, CRMConnector . I_FINANCE, CRMConnectorii' 
. I_GOVERNMENT, CRMConnector . I_HEALTHCARE , CRMConnector . I_MANUFACTURING, 
CRMConnector . I_RETAIL} ; 

Go[] industryGoNames = {new Go ( industryHREFNames [0] , true , Go . METHOD_GET) , new Go 

(industryHREFNames [1] , true , Go .METHOD_GET) , new Go (industryHREFNames [2] ,true,Goi^' 
.METHOD_GET) ,new Go ( industryHREFNames [3 ], true , Go . METHOD_GET) , new Go ^ 
(industryHREFNames [4] , true , Go .METHOD_GET) , new Go (industryHREFNames [5] ,true,Goi^ 
.METHOD_GET) ,new Go ( industryHREFNames [6] , true , Go . METHOD_GET) , new Go 
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(industryHREFNames [7] , true , Go .METHOD_GET) } ; 
String [] industryAnchorDisplayXext 

= { "^Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Healthcwf 

are" , "Manufacturing" , "Retail" } ; 
com. thinairapps . tag .wml .Anchor [] industryAnchorNames ={new com . thinairapps . tag . >^ 

wml -Anchor (industryOoNames [0] ,new Text ( IndustryAnchorDisplayText [0] ) ) ,new comi^ 

. thinairapps .tag .wml .Anchor (industryGoNames [1] , new Text 

(IndustryAnchorDisplayText [1] ) ) ,new com. thinairapps . tag . wml .Anchor ^ 
(industryGoNames [2] ,new Text (industryAnchorDisplayText [2] ) ) , new com. ^ 
thinairapps . tag .wml .Anchor (industryGoNames [3] , new Text \t 
(industryAnchorDisplayText [3] ) ) ,new com. thinairapps . tag . wml .Anchor 
(industryGoNames [4] , new Text ( industryAnchorDisplayText [4] )), new com. ^ 
thinairapps . tag .wml .Anchor (industryGoNames [5] , new Text ^ 
(industryAnchorDisplayText [5] ) ) ,new com. thinairapps . tag . wml . Anchor \£ 
(IndustryGoNames [6] , new Text (IndustryAnchorDisplayText [6] )), new com. ^ 
thinairapps . tag . wml .Anchor (industryGoNames [7] , new Text \£ 
(industryAnchorDisplayText [7] ) ) } ; 

for (i = 0; i < 8; i++) 
{ 

industryHREFNames [i] = CRMConnector . path+ "?" + CRMConnector .ACTION_FIELD 

+ "=" + industryURLParams [i] + "&rnd=" + Math . random () ; 
industryGoNames [i] = new Go ( industryHREFNames [i] , true^. Go . METHOD_GET) ; 
if ( CRMConnector. g_DEVICE instanceof NokiaWAPDevice) 
{ 

p.addChild(new Break () ) ; 

industryAnchorNames [i] = new Anchor ( industryGoNames [i] , new Text 

(industryAnchorDisplayText [i] ) ) ; 
p.addChild(industryAnchorNames [i] ) ,- 
p.addChild(new Break () ) ; 



industryAnchorNames [i] = new Anchor { industryGoNames [i] , 

(industryAnchorDisplayText [i] ) ) ; 
p. addChild( industryAnchorNames [i] ) ; 



//add the second Paragraph to the card 
cardl . addParagraph (p) ; 

//add the card to the deck 
deck. addCard (cardl) ; 

} 

else if (view. equals (CRMConnector .VIEW BY SALESCONTACT)) 
{ 

Bold b = new Bold (new Text ("View By Sales Contact:")); 
p.addChild(b) ; 
p.addChild(new Break {) ) ; 

//add the Paragraph to the card 
cardl .addParagraph (p) ; 

p = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 

//Add links to all the possible actions 
String [] salescontactHREFNames 

= {"arHref", "jfHref "ItHref", "myHref ", "mbHref "ndHref", "rfHref "sdHref "}; 
String [] salescontactURLParams = {CRMConnector . SC_ARTHUR_RIMBAUD, CRMConnector . 

SC_JOE_FRAZIER, CRMConnector . SC_LEON_TROTSKY, CRMConnector . SC_MICHELLE_YEOH , 

CRMConnector . SC_MIKHAIL_BULGAKOV, CRMConnector . SC_NEIL_DIAMOND, CRMConnector . 

SC_RICHARD_FEYNMAN, CRMConnector . SC_SAM_D0NALDS0N} ; 
Go[] salescontactGoNames = {new Go (salescontactHREFNames [0] , true , Go. METHOD_GET) , 

new Go (salescontactHREFNames [1] , true, Go. METHOD_GET) , new Go 

(salescontactHREFNames [2] , true , Go . METHOD_GET) , new Go ( salescontactHREFNames 
[3] , true,Go.METHOD_GET) , new Go (salescontactHREFNames [4] , true , Go.METHOD_GET) , 
new Go (salescontactHREFNames [5] , true, Go .METHOD_GET) , new Go 

(salescontactHREFNames [6] , true , Go . METHOD_GET) , new Go ( salescontactHREFNames 
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[ 7 ] , t rue , Go . METHOD_GET ) } ; 

String [] salescontactAnchorDisplayText = {"Arthur Rimbaud" , "Joe Frazier " , "Leon ^ 
Trotsky" , "Michelle Yeoh" , "Mikhail Bulgakov" , "Neil Diamond" , "Richard \i 
Feynman" , "Sam Donaldson" } ; 

com. thinairapps. tag. wml. Anchor [] salescontactAnchorNames ={new com . thinairapps . ^ 
tag. wml .Anchor (salescontactGoNames [0] ,new Text (salescontactAnchorDisplayText 
[0] ) ) ,new com. thinairapps. tag. wml .Anchor (salescontactGoNames [1] , new Text 
(salescontactAnchorDisplayText [1] ) ) , new com. thinairapps . tag .wml .Anchor i/" 
(salescontactGoNames [2] , new Text (salescontactAnchorDisplayText [2] )) ,new com. \^ 
thinairapps. tag. wml .Anchor (salescontactGoNames [3] , new Text 
(salescontactAnchorDisplayText [3] ) ) ,new com. thinairapps . tag .wml .Anchor 
(salescontactGoNames [4] , new Text (salescontactAnchorDisplayText [4] )) ,new com. \^ 
thinairapps . tag .wml .Anchor (salescontactGoNames [5] , new Text 
(salescontactAnchorDisplayText [5] ) ) ,new com. thinairapps . tag .wml .Anchor 
(salescontactGoNames [6] , new Text (salescontactAnchorDisplayText [6] )) ,new com. 
thinairapps. tag. wml .Anchor (salescontactGoNames [7 J , new Text 
(salescontactAnchorDisplayText [7] ) ) } ; 

for (i = 0; i < 8; i++) 
{ 

salescontactHREFNames [i] = CRMConnector . path+ "?" + CRMConnector . ACTION_FIELDL!r 

+ "=" + salescontactURLParams [i] + "&rnd=" + Math . random () ; 
salescontactGoNames [i] = new Go (salescontactHREFNamesJi] , true. Go .METHOD_GET) ,- 
if (CRMConnector .g DEVICE instanceof NokiaWAPDevice) 
{ 

p . addChild ( new Break ( ) } ; 

salescontactAnchorNames [i] = new Anchor (salescontactGoNames [i] , new Text 

(salescontactAnchorDisplayText [i] ) ) ; 
p. addChild (salescontactAnchorNames [i] ) ; 
p . addChild ( new Break ( ) ) ; 

} 

else 
{ 

salescontactAnchorNames [i] = new Anchor (salescontactGoNames [i] , new Text \i 

(salescontactAnchorDisplayText [i] ) ) ; 
p. addChild (salescontactAnchorNames [i] ) ; 

} 

is ^ 

//add the second Paragraph to the card 
cardl.addParagraph(p) ; 

//add the card to the deck 
deck.addCard(cardl) ; 

} 

String resultString = deck . render () ; 
return resultString; 



/** 

*A user selects a field value by which to sort the contents of the folder and 

* then this method is called to display all the items that have that value 

* ©param fieldValue The value of the field by which the user wants to sort the folder 

* ©param access A handle to ConnectorAccess and the ThinAir Server services 

* ©param sessionid An identifier of the user's already established session 

* ©return A collection of Storeltems that satisfy the criteria of the user 
*/ 

static String viewByField (String fieldValue, ConnectorAccess access, String sessionid) 
throws Exception 

{ 

//Create the deck, and add a few elements to it 
WMLTagDocument deck = new WMLTagDocument ( ) ; 
String url = null; 

DisplayCard card = new DisplayCard ( "cl " ) ; 

Paragraph p = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP) ; 
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Bold b = new Bold(new Text ( "Matching Items:")); 
p.addChild(b) ; 
p.addChild{new Break { ) ) ; 
card.addParagraph (p) ; 

Paragraph p2 = new Paragraph ( Paragraph .ALIGN_LEFT, Paragraph .MODE_NOWRAP) ,- 

//The cache for this session 
Hashtable cache = null ; 

//The Vector that will store the items that have fields that match the incoming 
//field parameter 

Vector itemswMatchingf ields = new Vector (IB) ; 

//Get the cache for this session 

cache = access .getSessionCache (sessionid) ; 

//Retrieve the Store Items that we've already placed into the cache 
Storeltems customltems = ( (Storeltems) cache .get (" storeitems" )) ; 

//we get an Enumeration of the items... 

Enumeration sortedltemEnum = (( (Vector) customltems) . elements ()) ; 
boolean didAnyltemsMatch = false; 

//Go through the items, and identify those that have the field that 

//has been passed in as the search parameter. 

int itemlterated = 0 ; 

String elementNumber = "elemnum" ; 

String href = ""; 

Go go = new Go (href, true. Go . METHOD_GET) ,- 
Anchor itemAnchor; 

while (sortedltemEnum. hasMoreElements ( ) ) 
{ 

String fieldText = null ; 
String companyName = null; 

Customltem custltem = (Customl tern) sortedltemEnum. nextElement () ; 
//Get the fields of the item 

Data customFields = custltem. getCustomFieldData {) ; 
//Get an enumeration of the fields 

Enumeration fieldEnum = customFields . getFields () ; 

//If the search parameter matches a field on the item, then we return a link to \£ 
the 

//item with the item's company name displayed. 

boolean hasField = false; 

while (fieldEnum. hasMoreElements () ) 

{ 

Field thisField = (Field) fieldEnum . nextElement () ; 

//Get the Item's Company Name field. We need it for displaying a link to thei^ 
item. 

if (thisField. getName (). equals ("CompanyName")) 
{ 

companyName = thisField. getstring () ; 

if (hasField == true) 

{ 

//Create the link to the Item, with the Company Name field rendered 
href = CRMConnector .path+ "?" + CRMConnector . ACTION_FIELD + "=" + ^ 

CRMConnector.VIEW_BY_FIELD_ACTION + " &amp ; elemnum= " + ^ 

itemlterated + "&rnd=" + Math . random () ; 

go = new Go (href, true. Go .METHOD_GET) ; 

if (CRMConnector .g_DEVICE instanceof NokiaWAPDevice ) 
{ 

itemAnchor = new Anchor (go, new Text (companyName) ) ; 
p2 .addChild(new Break () ) ; 
p2 .addChild( itemAnchor) ; 

} 
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else 
{ 

iteiuAnchor = new Anchor (go, new Text (companyName) ) ; 
p2 .addChild(itemAnchor) ; 

} 

p2.addChild(new BreakO); 
didAnyltemsMatch = true; 

companyName = null ; 
hasField = false; 
break; 

}^ 

continue; 

} 

//We will display links only to those items that match the search criteria 

else if (thisField.getStringO .equals (fieldValue) ) 

{ 

hasField = true; 

if (! (companyName == null)) 

{ 

//Create the link to the Item, with the Company Name field rendered 
href = CRMConnector .path+ "?" + CRMConnector . ACTION_FIELD + "=" + ^ 

CRMConnector .VIEW_BY_FIEIjD_ACTION + "& elemnum= " + 

itemlterated + "&rnd=" + Math. random () ; 

go = new Go (href, true. Go .METHOD_GET) ; 

if (CRMConnector .g_DEVICE instanceof NokiaWAPDevice) 
{ 

itemAnchor = new Anchor (go, new Text (companyName) ) ; 
p2.addChild(new BreakO ) ; 
p2 .addChildC itemAnchor) ; 

} 

else 
{ 

itemAnchor = new Anchor (go, new Text (companyName)}; 
p2 .addChild( itemAnchor) ; 

} 

p2 . addChild (new Break () ) ; 
didAnyltemsMatch = true; 

companyName = null ; 
hasField = false; 
break; 

} 

else 

continue; 

} 

} // end while 
itemlterated++ ; 
} 

//If no items matched the criteria, render this fact 

if (didAnyltemsMatch == false) 

{ 

p2 .addChild (new BreakO ) ; 

p2. addChild (new Text ("No Items to Display")); 
p2. addChild (new BreakO ) ; 
p2. addChild (new BreakO ) ; 

} 

//Else add one more break 

else if (! (didAnyltemsMatch == false)) 

{ 

p2 . addChild (new Break () ) ; 

} 
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//link home. 

String startHref = CRMConnector .path+ " ?rnd= "+Math . random () ; 

Go startGo = new Go (startHref , true, Go .METHOD_GET) ; 
Anchor startaAnchor ; 

if (CRMConnector .g DEVICE instanceof NokiaWAPDevice) 
{ 

p2 . addChild (new Break ( ) ) ; 

StartaAnchor = new Anchor (startGo, new TextC'Start again ...")) ; 
p2 . addChild ( startaAnchor) ; 

} 

else 
{ 

StartaAnchor = new Anchor (startGo, new TextC'Start again ...")) ,- 
p2 .addChild (startaAnchor) ; 

} 

card.addParagraph(p2) ; 
deck.addCard (card) ; 
return deck. render () ; 



/** 

* Renders an input form with the values preset 

* Pass in the field values that the item had. 

* ©param item -- 

* ®param messagelD -- 

*/ 

static String editItem(CustomItem item, String messagelD) 
{ 

//Get the Data object that contains all our custom fields. 
Data customFields = item.getCustomFieldData ( ) ; 

//Get the fields that we're expecting 

String customerNaraeField = customFields .getPield { "CustomerName" ) .valueToString () ; 
String positionField = customFields .getField ( "Position" ) .valueToString () ,- 
String companyNameField = customFields . getField ( "CompanyName" ) .valueToString () ; 
String industryField = customFields .getField { "Industry" ) .valueToString () ; 
String itemCreatedPield = customFields . getField (" ItemCreated" ) .valueToString () ,- 
String salesContactField = customFields .getField ( "Salescontact ") .valueToString () ; 
String accountNumberField = customFields .getField( "AccountNumber" ) .valueToString () ; 
string customerStatusField = customFields .getField ( "CustomerStatus" ) .valueToString () ; 

//Create the deck 

WMLTagDocument deck = new WMLTagDocument ( ) ; 
//Create a MultiplelnputCard 

MultiplelnputCard cardl = new MultiplelnputCard ( "gl ") ; 

//Allow the user to type in information and set the i 
Labeledlnput custName = new Labeledlnput ( "cstnm" , "Cus 
custName . setFormat ( " *m" ) ; 
//Set the default value 

custName . addAttribute ("value", customerNameField) ; 

Labeledlnput position = new Labeledlnput ( "psn" , "Position: ") ; 
position. setFormat {" *m" ) ; 
//Set the default value 

position. addAttribute ("value", positionField); 

Labeledlnput compName = new Labeledlnput ( "cnm" , "Company Name : " ) ; 
compName . setFormat ( " *m" ) ; 
//Set the default value 

compName .addAttribute ("value", companyNameField); 
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Label edinput [] inputsl = {custName, position, compName}; 
//A link to the second card 

cardl .buildCard( "#g2" , "OK" , inputsl , Go .METHOD_GET) ; 
deck.addCard(cardl) ; 

//Create a select card 

Card card2 = new Card ("g2", "industry"); 
//Create the Do 

Do doElem = new Do(Do.TYPE_ACCEPT,new Go (" #g3 false )) ; 

//Add the do 

card2 . addChild (doElem) ; 

//Create a paragraph 

Paragraph p = new Paragraph (Paragraph. ALIGN_LEFT, Paragraph. MODE_NOWRAP ) ; 
p. addChild (new Text ( "Industry: ") ) ; 

//Add the paragraph 
card2 .addParagraph(p) ; 

//Add another paragraph 

Paragraph p2 = new Paragraph (Paragraph .ALIGN_LEFT, Paragraph. MODE^NOWRAP) ; 
//Create a select 

Select industrySelect = new Select ("", "industry" , false) ; 

String [] industryOptionNames 

= { "Advertising" , "Consulting" , "Entertainment" , "Finance" , "Government" , "Health 

Care" , "Manufacturing" , "Retail" } ; 
Option [] industryOptions = new Option [8]; 

String [] industryOptionValues = { "a" , "b" , "c" , "d" , "e" , "f " , "g" , "h" } ,- 
String [] industryOptionlValues = { "1 " , "2 " , "3 " , "4 " , " 5 " , " 6 " , " 7 " , " 8 " } ; 

int i ,- 

for (i=0; i<8; i++) 
{ 

industryOptions [i] = new Option ( "OK" , industryOptionValues [ i] , industryOptionNames 
Ci] ) ; 

industrySelect. addOption( industryOptions [i] ) ; 

if (industryField. equals (industryOptionValues [i] ) ) 

industrySelect . setlNameAndlValue (industryOptionValues [i] , industryOptionlValues 
[i] ) ; 

} 

//Add the select to the paragraph 
p2 . addChild (industrySelect) ; 

//Add the second paragraph 
card2 . addChild (p2 ) ; 



//Create a select for Sales Contact 
Card cards = new Card ("g3"); 

//Create the Do 

Do salesDo = new Do (Do.TYPE_ACCEPT,new Go ( "#g4 ", false) ) ; 

//Add the do 

cards .addChild (salesDo) ; 

//Create a paragraph 

Paragraph sP = new Paragraph ( Paragraph. ALIGN_LEFT, Paragraph.MODE_NOWRAP) ; 
sP. addChild (new Text ("Sales Contact:")); 
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//Add the paragraph 
cards .addParagraph(sP) ; 

//Add another paragraph 

Paragraph sP2 = new Paragraph ( Paragraph. ALIGN_LEFT, Paragraph . MODE_NOWRAP ) ; 
//Create a select 

Select salesSelect = new Select ("", "salescontact" , false) ; 

String [] salesOptionNames = {"Mikhail Bulgakov" , "Neil Diamond" , "Sam Donaldson" , "Richard 

Feynman " , " Joe Frazier" , "Arthur Rimbaud" , "Leon Trotsky" , "Michelle Yeoh"}; 
Option [] salesOptions = new Option [8] ,- 

String [] salesOptionValues = { "a" , "b" , "c" , "d" , "e" , "f " , "g" , "h" } ; 
String [] salesOptionlValues = { " 1" , "2" , "3 " , "4 " , "5" , "6" , "7" , "8" } ; 

int k; 

for (k=0; k<8; k++) 
{ 

salesOptions [k] = new Option ( "OK" , salesOptionValues [k] , salesOptionNames [k] ) ; 

salesSelect. addOption( salesOptions [k] ) ; 

if (salesContactField. equals (salesOptionValues [k] ) ) 

salesSelect . set iNameAndl Value (salesOptionValues [k] , salesOptionlValues [k] ) ; 

} 

//Add the select to the paragraph 
sP2 .addChild(salesSelect) ; 

//Add the second paragraph 
cards. addChild(sP2) ; 

//Add the card 
deck. addCard (cards) ; 

//Create a MultiplelnputCard 

MultiplelnputCard card3 = new MultiplelnputCard ( "g4" ) ,- 

Labeledlnput actNumber = new Labeledlnput ( "an" , "Account Number:"); 
actNumber.setFormat {"*ra") ; 

actNumber .addAt tribute ( "value " , accountNumberField) ; 

Labeledlnput [] inputs2 = {actNumber}; 

cards. buildCard("#gS", "OK", inputs2, Go.METHOD_GET) ; 
deck. addCard( cards) ; 



//Create a select card 

Card carde = new Card ("gS", "Customer Status"); 
//Create a paragraph 

Paragraph p3 = new Paragraph ( Paragraph. ALIGN_LEFT, Paragraph. MOD E_NOWRAP) ; 
p3 .addChild(new Text ( "Customer Status")); 

//Add the paragraph 
cards . addParagraph (p3 ) ; 

/ /Add another paragraph 

Paragraph p4 = new Paragraph (Paragraph. AL I GN_LEFT, Paragraph. MODE_NOWRAP ) ; 
//Create a select 

Select custstatusSelect = new Select ("", "cust status ", false) ; 

String [] custstatusOptionNames = {"Needs First Contact ", "Needs Follow-Up" , "Needs Credit u< 
Approval ", "Needs to be Invoiced" , "Credit Approved" Invoice Sent "," Credit ^ 
Denied" , "Dead End" } ; 

Option[] custstatusOptions = new Option [8]; 

String [] custstatusOptionValues = { "a " , "b " , "c " , " d" , " e " , " f " , "g " , "h" } ; 
String[] custstatusOptionlValues = { " 1" , " 2 " , " 3 " , "4 " , " 5 " , "6 " , "7 " , "8 " } ; 
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inn J ; 

for (j=0; j<8; j++) 
{ 

custstatusOptions [ j ] = new Option ( "OK" , custstatusOptionValues [ j ] , 

custstatusOptionNames [j] ) ; 
custstatusSelect .addOption (custstatusOptions [j] ) ; 
if (customerStatusField. equals (custstatusOptionValues [j ]) ) 

custstatusSelect . set INameAndlValue (custstatusOptionValues [j ] , 
custstatusOptionlValues [j] ) ; 

} 

//Set the URL params to the values in the WML variables 

//&anip; , the escape sequence for ampersand, delimits name-value pairs. $ is used to 

dereference a WML variable . 
String href ; 

href = CRMConnector .path + "?action=" + CRMConnector . UPDATE_ACTION + "Samp ;"+ "Message ID 
= "+messageID+ " &cstnm=$cstnm&psn=$psn&amp ; cnm=$cnm& industry=$industry& 
spm=$ spm& sc=$ salescontact &amp ; an=$an&amp ; custstatus=$cust status&amp ; rnd= " +Math . 
random ( ) ; 

//Create the Do 

Do custDo = new Do (Do . TYPE_ACCEPT, new Go (href , false) ) ; 

//Add the do 

cards. addChild(custDo) ; 

//Add the select to the paragraph 
p4 .addChild(custstatusSelect) ; 

//Add the second paragraph 
card6.addChild(p4) ; 

//Add the card 
deck.addCard(card6) ; 

//Render the deck 
return deck . render ( ) ; 
} 

/-/end Connector 

y 
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